Joshua Jordan

<p>Dependent Media Live Rates for USPS calculates real-time USPS shipping rates at checkout using your own USPS Developer Portal credentials, by talking directly to the USPS REST API (the current API — not the retired Web Tools API).</p>
<p>This plugin is <strong>not affiliated with or endorsed by the United States Postal Service</strong>. “USPS” is a trademark of the United States Postal Service and is used in this plugin’s name solely to describe the service the plugin integrates with.</p>
<h4>Domestic US</h4>
<ul>
<li>USPS Ground Advantage</li>
<li>USPS Priority Mail</li>
<li>USPS Priority Mail Express</li>
</ul>
<h4>International</h4>
<ul>
<li>USPS First-Class Package International</li>
<li>USPS Priority Mail International</li>
<li>USPS Priority Mail Express International</li>
</ul>
<h4>Other features</h4>
<ul>
<li>Per-product weight and dimensions, with configurable defaults for products that have none set</li>
<li>Separate domestic and international service toggles — enable only what you want to offer</li>
<li>Automatic routing: the plugin detects destination country and hits the right USPS endpoint</li>
<li><strong>Multi-box packing</strong> by default — each cart line item is rated as its own package and costs are summed. Heavy lines are automatically split across multiple boxes to stay within USPS weight caps. A “combined” mode is also available for stores that genuinely ship everything in one box.</li>
<li>Only services that price every box are offered — partial coverage would produce a misleading total</li>
<li>Optional fallback flat rate if the USPS API is unreachable</li>
<li>Debug logging via WooCommerce <span aria-hidden="true" class="wp-exclude-emoji">→</span> Status <span aria-hidden="true" class="wp-exclude-emoji">→</span> Logs</li>
</ul>
<h4>You bring your own USPS API credentials</h4>
<p>This plugin does not proxy rate requests through any third party. You register your store as a USPS Developer Portal application once, paste the Consumer Key and Consumer Secret into the plugin settings, and rates go directly from USPS to your site. There is no monthly fee and no per-request cost.</p>
<p>Register at: <a href="https://developers.usps.com/" rel="nofollow ugc">https://developers.usps.com/</a></p>
<h4>Privacy</h4>
<p>When a customer reaches checkout, the plugin sends the destination postal code (and country, for international) along with the package dimensions and weight to the USPS REST API at <code>apis.usps.com</code>. No customer name, email, or other personally identifying information is transmitted. OAuth2 access tokens are cached locally in a WordPress transient.</p>
<h4>Source code</h4>
<p>Development happens on GitHub: <a href="https://github.com/Dependent-Media/dm-usps-shipping" rel="nofollow ugc">https://github.com/Dependent-Media/dm-usps-shipping</a>. Issues and pull requests welcome.</p>
<h3>External services</h3>
<p>This plugin connects to the USPS (United States Postal Service) REST API to obtain live shipping rates at WooCommerce checkout. This is the entire purpose of the plugin: without this connection, no rates can be calculated.</p>
<p><strong>What is the service?</strong> The USPS REST API at <code>https://apis.usps.com</code>, operated by the United States Postal Service. The plugin uses two endpoints:</p>
<ul>
<li><code>POST /oauth2/v3/token</code> — to obtain an OAuth2 access token using the merchant’s USPS Developer Portal Consumer Key and Consumer Secret.</li>
<li><code>POST /prices/v3/total-rates/search</code> and <code>POST /international-prices/v3/total-rates/search</code> — to obtain shipping rates for a given package.</li>
</ul>
<p><strong>What data is sent, and when?</strong></p>
<ul>
<li>When a customer reaches the WooCommerce shipping calculation step (typically the Cart or Checkout page), the plugin sends, for each package being rated: the origin ZIP code (configured by the merchant), the destination postal code, the destination country, and the package weight, length, width, and height.</li>
<li>When the plugin needs to authenticate to the USPS API (the first time, and again when the cached token has expired), it sends the merchant’s USPS Consumer Key and Consumer Secret to the OAuth2 token endpoint.</li>
<li>No customer name, email address, IP address, or other personally identifying information is transmitted to USPS by this plugin.</li>
</ul>
<p><strong>Who provides the service?</strong> The United States Postal Service.</p>
<ul>
<li>USPS Developer Portal Terms and Conditions: <a href="https://developers.usps.com/terms-and-conditions" rel="nofollow ugc">https://developers.usps.com/terms-and-conditions</a></li>
<li>USPS Privacy Policy: <a href="https://www.usps.com/privacypolicy/" rel="nofollow ugc">https://www.usps.com/privacypolicy/</a></li>
</ul>
<p><strong>Is the use of this service required?</strong> Yes. Calculating live USPS rates is the plugin’s only function, and it cannot be performed without contacting the USPS REST API. Merchants who do not wish to use this service should not install or activate this plugin.</p>


Dependent Media Live Rates for USPS

Live USPS rates for WooCommerce via the current USPS REST API. Domestic and international, with multi-box packing. No middleman, no monthly fee.

Ramin Hakimi

<p>نمایش قیمت لحظه‌ای طلا، ارز، سکه و رمزارزها با نوار چسبان قابل سفارشی‌سازی.</p>
<h3>سرویس‌های خارجی</h3>
<p>این پلاگین برای کارکرد به سرویس‌های زیر وابسته است:</p>
<h3>سرویس Nerkh.IO</h3>
<ul>
<li>توضیح سرویس: Nerkh.IO داده‌های لحظه‌ای بازار مالی (طلا، ارز، سکه و رمزارزها) را از طریق REST API ارائه می‌دهد.</li>
<li>مورد استفاده: دریافت قیمت‌های زنده برای نمایش در سایت از طریق ویجت شورتکد و/یا نوار چسبان قیمت.</li>
<li>داده‌های ارسالی و زمان ارسال:<br />
– کلید API (برای احراز هویت) با هر درخواست به api.nerkh.io ارسال می‌شود.<br />
– درخواستی زمانی ارسال می‌شود که مدیر از بخش تنظیمات پلاگین اقدام به “تست” یا “اتصال” کند.<br />
– درخواست‌های خودکار در بازه‌های زمانی مشخص (هر ۱۰، ۳۰ یا ۶۰ دقیقه) از طریق کرون وردپرس برای بروز نگه داشتن قیمت‌ها ارسال می‌شود.<br />
– هیچ داده شخصی کاربر یا بازدیدکننده ارسال نمی‌شود.</li>
</ul>
<h3>وب‌سایت Nerkh.IO (nerkh.io)</h3>
<ul>
<li>توضیح سرویس: وب‌سایت اصلی سرویس Nerkh.IO.</li>
<li>مورد استفاده: لینک “نرخ ❤” (ارجاع برند) در نوار چسبان قیمت در فرانت‌اند نمایش داده می‌شود که به https://nerkh.io لینک دارد. این مورد مطابق شرایط استفاده از API الزامی است.</li>
<li>داده‌های ارسالی: هیچ داده‌ای از پلاگین به nerkh.io ارسال نمی‌شود. لینک فقط در مرورگر برای کلیک کاربر نهایی نمایش داده می‌شود.</li>
<li>ارائه‌دهنده: Nerkh.IO</li>
<li>وب‌سایت: https://nerkh.io</li>
<li>شرایط استفاده: https://nerkh.io/terms</li>
<li>سیاست حریم خصوصی: https://nerkh.io/privacy</li>
</ul>
<h3>توضیحات</h3>
<p>پلاگین نرخ زنده یک افزونه حرفه‌ای وردپرس است که به شما امکان می‌دهد قیمت لحظه‌ای طلا، ارز، سکه و رمزارزها را در سایت خود نمایش دهید.</p>
<p>پلاگین داده‌های مالی لحظه‌ای را از یک وب‌سرویس API دریافت کرده و به‌صورت خودکار نرخ‌ها را با استفاده از یک نوار چسبان قابل سفارشی‌سازی در سایت شما نمایش می‌دهد.</p>
<p>کاربران به‌راحتی می‌توانند پلاگین را با وارد کردن کلید API خود از سایت اصلی به API متصل کنند.</p>
<p>پلاگین کاملاً رایگان است و با وردپرس و ووکامرس سازگار است.</p>
<h3>ویژگی‌های اصلی</h3>
<ul>
<li>نمایش قیمت لحظه‌ای طلا</li>
<li>نمایش قیمت لحظه‌ای ارز</li>
<li>نمایش قیمت لحظه‌ای سکه</li>
<li>نمایش قیمت لحظه‌ای رمزارزها</li>
<li>دریافت خودکار قیمت از API</li>
<li>تنظیم فاصله زمانی بروزرسانی:
<ul>
<li>هر ۱۰ دقیقه</li>
<li>هر ۳۰ دقیقه</li>
<li>هر ۶۰ دقیقه</li>
</ul>
</li>
<li>نوار چسبان قیمت</li>
<li>نمایش در بالای یا پایین سایت</li>
<li>سفارشی‌سازی کامل استایل</li>
<li>تنظیم رنگ پس‌زمینه</li>
<li>پشتیبانی از حالت تیره و روشن</li>
<li>رنگ‌بندی دلخواه برای هر آیتم</li>
<li>تنظیم رنگ قیمت</li>
<li>تنظیم رنگ جداکننده</li>
<li>تنظیم رنگ نماد واحد</li>
<li>تنظیم اندازه فونت</li>
<li>انتخاب آیتم‌های نمایش</li>
<li>پشتیبانی از بیش از ۲۳ آیتم مالی</li>
<li>تست اتصال API</li>
<li>تست دریافت پاسخ API</li>
<li>نصب و راه‌اندازی آسان</li>
<li>سازگار با ووکامرس</li>
<li>سبک و بهینه</li>
</ul>
<h3>آیتم‌های پشتیبانی شده</h3>
<p>پلاگین دسته‌بندی‌های مختلف مالی را پشتیبانی می‌کند:</p>
<ul>
<li>طلا</li>
<li>سکه</li>
<li>دلار</li>
<li>یورو</li>
<li>ارزهای خارجی</li>
<li>بیت‌کوین</li>
<li>تتر</li>
<li>رمزارزها</li>
<li>ارزهای دیجیتال</li>
</ul>
<h3>نصب</h3>
<p>۱. فایل‌های پلاگین را در پوشه <code>/wp-content/plugins/</code> آپلود کنید.<br />
۲. پلاگین را از منوی ‘افزونه‌ها’ در وردپرس فعال کنید.<br />
۳. صفحه تنظیمات نرخ زنده را باز کنید.<br />
۴. کلید وب‌سرویس خود را وارد کنید.<br />
۵. تنظیمات را ذخیره کنید.<br />
۶. استایل نمایش و فاصله بروزرسانی را تنظیم کنید.<br />
۷. تمام! قیمت‌های زنده اکنون در سایت شما نمایش داده می‌شود.</p>
<h3>پرسش‌های متداول</h3>
<h4>آیا پلاگین رایگان است؟</h4>
<p>بله. نرخ زنده کاملاً برای کاربران وردپرس و ووکامرس رایگان است.</p>
<h4>چگونه پلاگین را به API متصل کنم؟</h4>
<p>کلید وب‌سرویس خود را از سایت اصلی دریافت کرده و در صفحه تنظیمات پلاگین وارد کنید.</p>
<h4>آیا می‌توانم طراحی را سفارشی کنم؟</h4>
<p>بله. می‌توانید رنگ‌ها، فونت‌ها، موقعیت نوار چسبان و استایل نمایش را کاملاً سفارشی‌سازی کنید.</p>
<h4>آیا می‌توانم آیتم‌های نمایش را انتخاب کنم؟</h4>
<p>بله. می‌توانید فقط آیتم‌های مالی که می‌خواهید در سایت نمایش داده شود را انتخاب کنید.</p>
<h4>آیا پلاگین از بروزرسانی خودکار پشتیبانی می‌کند؟</h4>
<p>بله. پلاگین می‌تواند قیمت‌ها را هر ۱۰، ۳۰ یا ۶۰ دقیقه یک‌بار به‌صورت خودکار بروزرسانی کند.</p>
<h3>اسکرین‌شات</h3>
<p>۱. نوار چسبان قیمت زنده<br />
۲. پنل تنظیمات پلاگین<br />
۳. بخش تست اتصال API<br />
۴. انتخاب آیتم‌های مالی<br />
۵. تنظیمات سفارشی‌سازی نمایش</p>
<h3>تغییرات</h3>
<h4>2.1.13</h4>
<ul>
<li>رفع مشکل بروزرسانی اتوماتیک پلاگین</li>
</ul>
<h4>2.1.9</h4>
<ul>
<li>اضافه شدن شورت‌کد اختصاصی برای هر آیتم (مثل <code>[NERKH_GOLD18K]</code>، <code>[NERKH_USD]</code> و…)</li>
<li>شورت‌کدهای اختصاصی فقط عدد فرمت‌شده را نمایش می‌دهند (بدون واحد پول)</li>
<li>اضافه شدن باکس راهنمای شورت‌کدها در صفحه تنظیمات ادمین</li>
<li>اضافه شدن دکمه کپی با tooltip برای شورت‌کدها</li>
<li>اضافه شدن باکس راهنمای فایل‌های مستثنا از کش (برای LiteSpeed, WP Rocket, Cloudflare)</li>
<li>اضافه شدن تیک «بارگذاری قیمت‌ها به صورت AJAX» در تنظیمات (پیش‌فرض: فعال)</li>
<li>رفع نمایش کلید خام آیتم‌ها به جای لیبل فارسی در شورت‌کد اصلی</li>
<li>رفع مشکل فریز شدن قیمت‌ها با کش سرور (LiteSpeed Cache, WP Rocket, Cloudflare)</li>
</ul>
<h4>2.1.8</h4>
<ul>
<li>اضافه شدن حالت نمایش AJAX برای شورت‌کد قیمت‌ها — قیمت‌ها از طریق Ajax از دیتابیس خوانده می‌شوند و مشکل کش سرور (LiteSpeed Cache, WP Rocket, Cloudflare و…) رفع شد</li>
<li>اضافه شدن تیک «بارگذاری قیمت‌ها به صورت AJAX» در تنظیمات پلاگین (پیش‌فرض: فعال)</li>
<li>اضافه شدن هشدار رنگی برای کاربرانی که از کش سرور استفاده می‌کنند</li>
<li>اضافه شدن انیمیشن بارگذاری (loading pulse) هنگام دریافت قیمت‌ها</li>
<li>رفع نمایش کلید خام آیتم‌ها به جای لیبل فارسی در شورت‌کد</li>
</ul>
<h4>2.1.7</h4>
<ul>
<li>تکمیل فارسی‌سازی محیط و ادمین پلاگین</li>
</ul>
<h4>2.1.6</h4>
<ul>
<li>بروزرسانی مستندات سرویس خارجی — افشای کامل ارتباط API، شرایط استفاده و لینک سیاست حریم خصوصی در ریدمی</li>
<li>جایگزینی اسکریپت درون‌خطی با wp_enqueue_script() و wp_localize_script() مناسب برای جاوااسکریپت صفحه دیباگ</li>
<li>رفع مشکل فریز شدن قیمت‌های نوار چسبان توسط افزونه‌های کش (LS Cache, WP Rocket و…)</li>
<li>نوار چسبان اکنون قیمت‌ها را از طریق Ajax دریافت می‌کند تا از کش صفحه عبور کند</li>
<li>قیمت‌های نوار چسبان بر اساس فاصله زمانی کرون به‌صورت خودکار بروزرسانی می‌شوند</li>
<li>عنصر نوار به document.body اضافه می‌شود به جای document.documentElement</li>
</ul>
<h4>2.1.5</h4>
<ul>
<li>تقویت امنیت — تمام خروجی‌ها به‌درستی اسکیپ شده‌اند</li>
<li>رفع هشدارهای کوئری دیتابیس</li>
<li>بهبود سازگاری با PHPCS</li>
<li>بهبودهای کیفیت کد</li>
</ul>
<h4>2.1.4</h4>
<ul>
<li>رفع ساختار پلاگین</li>
<li>اضافه شدن فاصله زمانی بروزرسانی خودکار</li>
<li>اضافه شدن تست اتصال API</li>
<li>اضافه شدن نوار چسبان قابل سفارشی‌سازی</li>
<li>بهبود سازگاری با ووکامرس</li>
<li>بهبودهای عملکرد</li>
<li>بهبودهای رابط کاربری و تنظیمات</li>
</ul>
<h3>اعلان ارتقا</h3>
<h4>2.1.2</h4>
<p>اضافه شدن حالت AJAX برای نمایش قیمت‌ها و رفع مشکل کش سرور. قیمت‌های شورت‌کد اکنون از طریق Ajax بارگذاری می‌شوند.</p>
<h4>2.1.1</h4>
<p>اضافه شدن شورت‌کدهای اختصاصی هر آیتم، حالت AJAX برای جلوگیری از کش شدن قیمت‌ها، و راهنمای فایل‌های مستثنا از کش.</p>
<h4>2.1.1</h4>
<p>اضافه شدن مستندات کامل سرویس شخص ثالث برای انطباق با WordPress.org و تغییر اسکریپت‌های صفحه دیباگ به روش‌های مناسب enqueue وردپرس.</p>
<h4>2.1.0</h4>
<p>بروزرسانی‌های امنیتی و انطباق با بهبود کیفیت کد.</p>


Nerkh Live

نمایش قیمت لحظه‌ای طلا، ارز، سکه و رمزارزها با نوار چسبان قابل سفارشی‌سازی.

Dependent Media Live Rates for USPS vs Nerkh Live