Steve Mulligan

<p>A cache-compatible WordPress plugin which converts all prices of the currency of<br />
your choice in a post or page in the viewer’s local currency. LocalMoney relies<br />
on the WP-cron system to fetch and cache the rates from<br />
<a href="http://openexchangerates.org" title="The openexchangerates.org site" rel="nofollow ugc">Open Exchange Rates</a><br />
on an hourly basis and then uses javascript to lookup the visitor’s location and<br />
fetch the appropriate rate data. This means that, unlike some plugins I could mention,<br />
LocalMoney is compatible with caching plugins.</p>
<p>LocalMoney, once configured, immediately (or as soon as your cache updates) acts<br />
on all your posts and pages without you having to mark up the prices in your text.</p>
<h4>Features</h4>
<ol>
<li>Determines the reader’s country via IP address, using IP2C</li>
<li>Resolves proxies with the ‘forwarded-for’ header so AOL-compatible</li>
<li>If IP2C fails uses the language settings and timezone offset to guess location</li>
<li>Obtains exchange rates from openexchangerates.org</li>
<li>Uses AJAX so that converting currency values doesn’t delay page load times</li>
<li>Caches exchange rates locally to minimize calls to openexchangerates.org</li>
<li>Output prices matched to format of input prices (i.e. with or without cents)</li>
</ol>
<h4>How to Use</h4>
<p>Once LocalMoney is installed it will take any page on which US dollar prices are<br />
displayed and convert them to the visitors local currency. If your posts are written<br />
with another currency you can change the base currency in the Settings > LocalMoney<br />
page.</p>
<h3>Internationalization (i18n)</h3>
<p>Currently LocalMoney has not been translated to any languages other than English.</p>
<p>If you wish, feel free to create a translation. Here are the basic steps:</p>
<ol>
<li>Copy “localmoney-en.po” to “localmoney-LANG_COUNTRY.po” – fill in LANG and COUNTRY with whatever you use for WPLANG in wp-config.php.</li>
<li>Grab a transalation editor. <a href="http://www.poedit.net/" rel="nofollow ugc">POedit</a> works for us.</li>
<li>Translate each line.</li>
<li>Send your new localmoney-LANG_COUNTRY.po file to steve@machinesthatgobing.com.</li>
<li>Your translation will be incorporated in the next release.</li>
</ol>


LocalMoney

A cache-compatible plugin which converts all prices in a post or page into the viewer's local currency.

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

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

LocalMoney vs Nerkh Live