Perfex Sync for WordPress & WooCommerce
🔄 افزونه‌ای برای سینک کاربران وردپرس و مشتریان ووکامرس با پرفکس CRM. | 🔄 A plugin to sync WordPress users and WooCommerce customers with Perfex CRM.
by M. Amin Askari · github.com/aminaskarix/wp-woocommerce-to-perfex-sync · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/aminaskarix/wp-woocommerce-to-perfex-sync/archive/refs/heads/main.zip🇮🇷 فارسی
نمونهٔ افزونهٔ وردپرس برای ارسال دادهٔ کاربران ثبت‌نامی و برخی سفارش‌های ووکامرس به یک API پیکربندی‌شده.
⚙️ رفتار فعلی
- هوک
user_registerنام و ایمیل کاربر را ارسال می‌کند. - هوک
woocommerce_thankyouفقط برای سفارشی که کاربر ثبت‌نام‌شدهٔ مرتبط دارد تلاش به ارسال اطلاعات می‌کند. - صفحهٔ «Sync to Perfex» فیلدهای نشانی API و کلید را ذخیره می‌کند؛ درخواست POST با JSON و هدر Bearer ارسال می‌شود.
🛠️ نصب و پیکربندی
فایل‌های مخزن را در پوشه‌ای زیر wp-content/plugins/ بگذارید، افزونه را فعال کنید و در صفحهٔ تنظیمات نشانی endpoint و کلید معتبر را وارد کنید. ابتدا با API آزمایشی و دادهٔ غیرواقعی جریان را بررسی کنید.
⚠️ محدودیت‌های مهم
مخزن endpoint مشخصی برای Perfex ارائه نمی‌کند و سازگاری با نصب شما باید بررسی شود. آدرس و کلید پیش‌فرض در کد فقط مقدار نمایشی‌اند. کد هر پاسخ غیرخطای شبکه را موفق لاگ می‌کند و وضعیت HTTP را اعتبارسنجی نمی‌کند؛ برای همگام‌سازی مطمئن به مدیریت خطا و تکرار نیاز است. فایل functions.php نسخهٔ تکراری توابع را دارد و نباید هم‌زمان با فایل اصلی بارگذاری شود.
💡 جریان داده
این نمونه برای وصل‌کردن رویدادهای وردپرس به یک endpoint خارجی طراحی شده است. پس از ثبت کاربر، نام و ایمیل او در قالب JSON ارسال می‌شود. در مسیر ووکامرس، هوک صفحهٔ تشکر سفارش را بررسی می‌کند و اگر سفارش به کاربر ثبت‌شده وصل باشد، اطلاعات او را نیز می‌فرستد. پیکربندی از صفحهٔ مدیریت وردپرس خوانده می‌شود.
🧩 نقشهٔ فایل‌ها
| فایل | نقش |
|---|---|
index.php |
نقطهٔ ورود افزونه، تنظیمات و هوک‌های فعال |
functions.php |
تعریف‌های تکراری و جدا از نقطهٔ ورود |
admin.js و style.css |
دارایی‌های همراه مخزن |
🔎 این کد قرارداد API پرفکس را تأیید نمی‌کند. قبل از اتصال دادهٔ واقعی، ساختار endpoint، مجوز دسترسی، پاسخ‌های خطا و جلوگیری از ارسال تکراری را در محیط آزمایشی بررسی کنید.
👤 پدیدآورنده و حقوق نشر
© م.امین عسکری (M. Amin Askari). GitHub · وب‌سایت
📜 مجوز
این پروژه تحت مجوز MIT منتشر شده است؛ متن کامل در LICENSE آمده است.
🇬🇧 English
A WordPress plugin prototype that posts registration data and selected WooCommerce customer data to a configured API.
⚙️ Current behavior
user_registersends a registered user's name and email.woocommerce_thankyouattempts to send customer data only when the order has an associated registered user.- The “Sync to Perfex” admin page saves an API URL and key; requests are JSON POSTs with a Bearer header.
🛠️ Install and configure
Place the repository files in a folder under wp-content/plugins/, activate the plugin, and supply a valid endpoint and key in its settings page. First verify the flow against a test API with non-sensitive data.
⚠️ Important limitations
The repository does not specify a working Perfex endpoint; verify compatibility with your own installation. Defaults in the code are placeholders. The code does not validate HTTP status and lacks reliable retry/error handling. functions.php duplicates definitions from the main plugin file and must not be loaded alongside it.
💡 Data flow
This prototype connects WordPress events to an external endpoint. Registration sends a user's name and email as JSON. The WooCommerce thank-you hook also sends data when an order is linked to a registered user. The destination and key come from the WordPress settings page.
🧩 Repository map
| File | Purpose |
|---|---|
index.php |
Plugin entry point, settings, active hooks |
functions.php |
Duplicate definitions outside the entry point |
admin.js and style.css |
Additional checked-in assets |
🔎 This code does not prove compatibility with a particular Perfex API contract. Before sending real data, test the endpoint schema, permissions, error responses, and duplicate handling in a staging environment.
👤 Author and copyright
Copyright © M. Amin Askari (م.امین عسکری). GitHub · Website
📜 License
This project is licensed under MIT. See LICENSE for the full terms.