# راهنما · دلارچنده

> هر سه افزونه رایگان‌اند. بدون کلید ربات، API به آن‌ها ۴۰۱ می‌دهد. نرخ بازار آزاد به تومان است و توصیه خرید یا فروش نیست.

کلید را در گفتگوی خصوصی با https://t.me/DollarChandeBot و دستور `/key` بگیر. همان رشته را در تنظیمات افزونه بگذار.

## وردپرس

https://api.dollarchande.live/dl/wordpress

1. فایل فشرده را از پیشخوان بارگذاری کن، یا پوشه `dollarchande` را در `wp-content/plugins` بگذار.
2. افزونه را فعال کن.
3. از تنظیمات، دلارچنده، کلید را بگذار.
4. شورت‌کد را در برگه یا نوشته بگذار: `[dollarchande symbol="USD"]`.

در قالب، `dollarchande_rate('USD')` اگر نرخ نرسد `null` برمی‌گرداند. اگر نرخ نرسد یا خارج از بازه منطقی باشد، جمله «نرخ الان نرسید.» می‌آید و عدد قبلی عوض نمی‌شود.

## ووکامرس

https://api.dollarchande.live/dl/woocommerce

ووکامرس باید نصب باشد. قیمت = پایه × نرخ × ضریب، گردشده به گام. برای تومان ضریب ۱ است و برای ریال ضریب ۱۰. گام ۱۰۰۰ یعنی گرد به هزار. قیمت حراج دست نمی‌خورد. کالای متغیر را روی هر متغیر جدا روشن کن.

1. فایل را بارگذاری کن و افزونه را فعال کن.
2. از ووکامرس، دلارچنده، کلید و نماد را ذخیره کن.
3. در ویرایش کالا «به‌روزرسانی با دلارچنده» را روشن کن و قیمت پایه را بنویس.

هر ساعت یک دور اجرا می‌شود. «همگام‌سازی الان» همان کار را همان لحظه می‌کند. اگر نرخ منطقی نباشد، قیمت ذخیره‌شده همان می‌ماند.

## WHMCS

https://api.dollarchande.live/dl/whmcs

1. پوشه `dollarchande` را در `modules/addons` بگذار.
2. از Configuration، Addon Modules، دلارچنده را فعال کن.
3. کلید، نماد، شناسه ارز و ضریب را بنویس. شناسه، `tblcurrencies.id` ارز تومان یا ریال است.
4. ارز پیش‌فرض را انتخاب نکن. نرخ آن باید ۱ بماند. کران WHMCS باید روشن باشد.

فعال‌سازی ستون `rate` را به DECIMAL(18,8) پهن می‌کند. خاموش کردن جدول و نرخ را پاک نمی‌کند. کران حدود هر ساعت یک بار می‌نویسد. «Update now» همان کار را همان لحظه می‌کند. اگر نرخ خارج از بازه باشد، ستون `rate` عوض نمی‌شود.

## هشدار

در ربات. حداکثر ده هشدار برای هر گفتگو. عددهای زیر نمونه دستورند، نه قیمت زنده.

- `/alert USD above 180000` — یک‌بار، بعد از اعلان حذف می‌شود
- `/alert USD below 170000` — یک‌بار، وقتی قیمت به آستانه یا پایین‌تر برسد
- `/alert USD above 180000 every` — تکراری، تا برگشت قیمت دوباره اعلان نمی‌دهد
- `/alert USD below 170000 every` — همان تکرار، برای پایین‌تر
- `/alert USD move 2` — یک‌بار، حرکت دو درصد. نمونه اول فقط مبنا می‌شود
- `/alert USD move 2 every` — هر بار که از آخرین اعلان دو درصد جابه‌جا شود
- `/alerts` — فهرست همین گفتگو
- `/unalert 3` — حذف شماره ۳

کانال https://t.me/AlanDollarChande هر دور یک فهرست بی‌صدا می‌فرستد و برای آن اعلان نمی‌دهد.

صفحه: https://dollarchande.live/docs/
