{"id":29617442,"url":"https://github.com/nasserhaji/product-recommendation","last_synced_at":"2025-07-21T02:01:37.722Z","repository":{"id":304569911,"uuid":"1019170639","full_name":"nasserhaji/product-recommendation","owner":"nasserhaji","description":"A comprehensive and intelligent product recommendation system for WooCommerce that helps customers find the perfect products based on their preferences and characteristics.","archived":false,"fork":false,"pushed_at":"2025-07-13T22:53:34.000Z","size":221,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-14T00:29:06.337Z","etag":null,"topics":["product","product-recommendation","wordpress","wordpress-development","wordpress-plugin"],"latest_commit_sha":null,"homepage":"http://product-recommendation.mohammadnasser.com/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nasserhaji.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-13T22:29:14.000Z","updated_at":"2025-07-13T23:22:19.000Z","dependencies_parsed_at":"2025-07-14T00:29:21.689Z","dependency_job_id":"cd4c8e80-3f1a-4ff2-81ec-35046f380e7a","html_url":"https://github.com/nasserhaji/product-recommendation","commit_stats":null,"previous_names":["nasserhaji/product-recommendation"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/nasserhaji/product-recommendation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasserhaji%2Fproduct-recommendation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasserhaji%2Fproduct-recommendation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasserhaji%2Fproduct-recommendation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasserhaji%2Fproduct-recommendation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nasserhaji","download_url":"https://codeload.github.com/nasserhaji/product-recommendation/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasserhaji%2Fproduct-recommendation/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266226982,"owners_count":23895728,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["product","product-recommendation","wordpress","wordpress-development","wordpress-plugin"],"created_at":"2025-07-21T02:01:05.208Z","updated_at":"2025-07-21T02:01:37.716Z","avatar_url":"https://github.com/nasserhaji.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Product Recommendation System for WooCommerce\n\n[![WordPress](https://img.shields.io/badge/WordPress-5.0+-blue.svg)](https://wordpress.org/)\n[![WooCommerce](https://img.shields.io/badge/WooCommerce-5.0+-green.svg)](https://woocommerce.com/)\n[![PHP](https://img.shields.io/badge/PHP-7.4+-purple.svg)](https://php.net/)\n[![License](https://img.shields.io/badge/License-GPL%20v2%20or%20later-red.svg)](https://www.gnu.org/licenses/gpl-2.0.html)\n[![Version](https://img.shields.io/badge/Version-1.0.0-orange.svg)](https://github.com/nasserhaji/product-recommendation/releases)\n\nA comprehensive and intelligent product recommendation system for WooCommerce that helps customers find the perfect products based on their preferences and characteristics.\n\n---\n\n## 🌍 Multilingual Descriptions\n\n### 🇮🇷 Persian / فارسی\nسیستم جامع و هوشمند توصیه محصول برای ووکامرس که به مشتریان کمک می‌کند تا محصولات مناسب را بر اساس ترجیحات و ویژگی‌های خود پیدا کنند.\n\n### 🇸🇦 Arabic / العربية\nنظام توصية المنتجات الشامل والذكي لـ WooCommerce الذي يساعد العملاء في العثور على المنتجات المثالية بناءً على تفضيلاتهم وخصائصهم.\n\n### 🇨🇳 Chinese / 中文\n一个全面的智能产品推荐系统，适用于WooCommerce，帮助客户根据其偏好和特征找到完美的产品。\n\n### 🇷🇺 Russian / Русский\nКомплексная и интеллектуальная система рекомендаций продуктов для WooCommerce, которая помогает клиентам найти идеальные продукты на основе их предпочтений и характеристик.\n\n---\n\n## 🌟 Features\n\n### 🎯 Smart Recommendation Engine\n- **Interactive Questionnaire**: Dynamic form that guides customers to their ideal products\n- **Intelligent Matching**: Advanced algorithm that matches customer preferences with product characteristics\n- **Customizable Questions**: Add, edit, delete, and reorder questions from the admin panel\n- **Random Fallback**: Shows random products when no exact matches are found\n\n### 🌍 Multi-Language Support\n- **Persian/Farsi**: Full RTL support with native Persian interface\n- **English**: Complete English localization\n- **Russian**: Full Russian language support\n- **Chinese**: Traditional and Simplified Chinese support\n- **Arabic**: Complete Arabic RTL support\n- **Extensible**: Easy to add new languages using POT files\n\n### 🎨 Modern Design\n- **Responsive Design**: Works perfectly on all devices (desktop, tablet, mobile)\n- **Customizable Styling**: Adjust colors, fonts, and appearance to match your brand\n- **RTL Support**: Full right-to-left language support\n- **Modern UI**: Clean, professional interface with smooth animations\n\n### 🔧 Easy Integration\n- **Simple Shortcode**: Use `[product_recommendation_form]` anywhere on your site\n- **WooCommerce Integration**: Seamless integration with existing WooCommerce products\n- **Admin Management**: Complete control over questions, products, and settings\n- **AJAX Powered**: Fast, dynamic responses without page reloads\n\n## 📋 Requirements\n\n- **WordPress**: 5.0 or higher\n- **WooCommerce**: 5.0 or higher\n- **PHP**: 7.4 or higher\n- **MySQL**: 5.6 or higher\n\n## 🚀 Installation\n\n### Method 1: WordPress Admin (Recommended)\n\n1. Download the plugin ZIP file from the [releases page](https://github.com/nasserhaji/product-recommendation/releases)\n2. Go to your WordPress admin panel → Plugins → Add New\n3. Click \"Upload Plugin\" and select the downloaded ZIP file\n4. Click \"Install Now\" and then \"Activate Plugin\"\n\n### Method 2: Manual Installation\n\n1. Download the plugin files\n2. Upload the `product-recommendation` folder to `/wp-content/plugins/`\n3. Activate the plugin through the 'Plugins' menu in WordPress\n4. Go to 'Product Recommendation System' in the admin menu\n5. Configure your questions and settings\n\n### Method 3: Git Clone\n\n```bash\ncd wp-content/plugins/\ngit clone https://github.com/nasserhaji/product-recommendation.git\n```\n\n## ⚙️ Configuration\n\n### 1. Basic Setup\n\n1. **Activate the Plugin**: Go to Plugins → Product Recommendation System → Activate\n2. **Access Settings**: Navigate to Product Recommendation System in the admin menu\n3. **Configure Questions**: Set up your recommendation questions in the settings panel\n4. **Add Product Characteristics**: Assign characteristics to your WooCommerce products\n\n### 2. Customizing Questions\n\n```php\n// Example of adding custom questions programmatically\nadd_filter('product_recommendation_base_questions', function($questions) {\n    $questions[] = [\n        'id' =\u003e 'custom_question',\n        'question' =\u003e 'What is your preferred budget range?',\n        'type' =\u003e 'select',\n        'options' =\u003e [\n            'low' =\u003e 'Under $50',\n            'medium' =\u003e '$50 - $200',\n            'high' =\u003e 'Over $200'\n        ]\n    ];\n    return $questions;\n});\n```\n\n### 3. Styling Customization\n\nThe plugin supports custom CSS variables for easy styling:\n\n```css\n:root {\n    --pr-primary-color: #007cba;\n    --pr-font-color: #333333;\n    --pr-button-color: #007cba;\n    --pr-button-text-color: #ffffff;\n}\n```\n\n## 📖 Usage\n\n### Adding the Recommendation Form\n\nUse the shortcode anywhere on your site:\n\n```php\n// In a page or post\n[product_recommendation_form]\n\n// In a PHP template\necho do_shortcode('[product_recommendation_form]');\n\n// With custom attributes\n[product_recommendation_form title=\"Find Your Perfect Product\"]\n```\n\n### Programmatic Usage\n\n```php\n// Get product recommendations programmatically\n$answers = [\n    'budget' =\u003e 'medium',\n    'style' =\u003e 'modern',\n    'size' =\u003e 'large'\n];\n\n$recommendations = apply_filters('product_recommendation_get_products', [], $answers);\n```\n\n### Hooks and Filters\n\n```php\n// Customize the recommendation algorithm\nadd_filter('product_recommendation_matching_algorithm', function($algorithm, $answers) {\n    // Your custom logic here\n    return $algorithm;\n}, 10, 2);\n\n// Add custom product characteristics\nadd_filter('product_recommendation_product_characteristics', function($characteristics, $product_id) {\n    $characteristics['custom_field'] = get_post_meta($product_id, 'custom_field', true);\n    return $characteristics;\n}, 10, 2);\n```\n\n## 🌐 Localization\n\n### Supported Languages\n\n- **Persian/Farsi**: `fa_IR`, `fa_AF`, `fa_TJ`\n- **English**: `en_US`, `en_GB`, `en_CA`, `en_AU`, and more\n- **Russian**: `ru_RU`, `ru_UA`, `ru_BY`, `ru_KZ`, and more\n- **Chinese**: `zh_CN`, `zh_TW`, `zh_HK`, `zh_SG`, and more\n- **Arabic**: `ar_SA`, `ar_EG`, `ar_AE`, `ar_JO`, and more\n\n### Adding New Languages\n\n1. Copy the `languages/product-recommendation.pot` file\n2. Translate the strings using a tool like Poedit\n3. Save as `product-recommendation-{locale}.po`\n4. Compile to `product-recommendation-{locale}.mo`\n5. Place both files in the `languages` directory\n\n---\n\n## 🌍 Multilingual Detailed Descriptions\n\n### 🇮🇷 Persian / فارسی\n\n#### ویژگی‌های اصلی\n- **موتور توصیه هوشمند**: الگوریتم پیشرفته برای تطبیق ترجیحات مشتریان با ویژگی‌های محصولات\n- **فرم تعاملی**: پرسشنامه پویا که مشتریان را به محصولات ایده‌آل هدایت می‌کند\n- **سوالات قابل تنظیم**: امکان اضافه کردن، ویرایش، حذف و مرتب‌سازی سوالات از پنل مدیریت\n- **پشتیبانی چندزبانه**: پشتیبانی کامل از فارسی، انگلیسی، روسی، چینی و عربی\n- **طراحی واکنش‌گرا**: سازگار با تمام دستگاه‌ها (دسکتاپ، تبلت، موبایل)\n- **پشتیبانی RTL**: پشتیبانی کامل از زبان‌های راست به چپ\n- **یکپارچه‌سازی آسان**: استفاده از شورت‌کد `[product_recommendation_form]` در هر جای سایت\n\n#### نحوه استفاده\n```php\n// استفاده در صفحه یا پست\n[product_recommendation_form]\n\n// استفاده در قالب PHP\necho do_shortcode('[product_recommendation_form]');\n\n// با ویژگی‌های سفارشی\n[product_recommendation_form title=\"محصول مناسب خود را پیدا کنید\"]\n```\n\n#### نصب و راه‌اندازی\n1. فایل ZIP افزونه را از صفحه انتشارات دانلود کنید\n2. به پنل مدیریت وردپرس بروید → افزونه‌ها → افزودن جدید\n3. روی \"بارگذاری افزونه\" کلیک کنید و فایل ZIP را انتخاب کنید\n4. روی \"نصب اکنون\" و سپس \"فعال‌سازی افزونه\" کلیک کنید\n\n### 🇸🇦 Arabic / العربية\n\n#### الميزات الرئيسية\n- **محرك التوصية الذكي**: خوارزمية متقدمة لمطابقة تفضيلات العملاء مع خصائص المنتجات\n- **النموذج التفاعلي**: استبيان ديناميكي يوجه العملاء إلى منتجاتهم المثالية\n- **الأسئلة القابلة للتخصيص**: إمكانية إضافة وتحرير وحذف وإعادة ترتيب الأسئلة من لوحة الإدارة\n- **الدعم متعدد اللغات**: دعم كامل للفارسية والإنجليزية والروسية والصينية والعربية\n- **التصميم المتجاوب**: متوافق مع جميع الأجهزة (سطح المكتب والتابلت والهاتف المحمول)\n- **دعم RTL**: دعم كامل للغات من اليمين إلى اليسار\n- **التكامل السهل**: استخدام الشورت كود `[product_recommendation_form]` في أي مكان في الموقع\n\n#### كيفية الاستخدام\n```php\n// الاستخدام في الصفحة أو المنشور\n[product_recommendation_form]\n\n// الاستخدام في قالب PHP\necho do_shortcode('[product_recommendation_form]');\n\n// مع الخصائص المخصصة\n[product_recommendation_form title=\"ابحث عن منتجك المثالي\"]\n```\n\n#### التثبيت والإعداد\n1. قم بتحميل ملف ZIP الإضافة من صفحة الإصدارات\n2. اذهب إلى لوحة إدارة ووردبريس → الإضافات → إضافة جديدة\n3. انقر على \"رفع الإضافة\" واختر ملف ZIP\n4. انقر على \"تثبيت الآن\" ثم \"تفعيل الإضافة\"\n\n### 🇨🇳 Chinese / 中文\n\n#### 主要功能\n- **智能推荐引擎**: 先进的算法，将客户偏好与产品特性匹配\n- **交互式表单**: 动态问卷，引导客户找到理想产品\n- **可自定义问题**: 从管理面板添加、编辑、删除和重新排序问题\n- **多语言支持**: 完整支持波斯语、英语、俄语、中文和阿拉伯语\n- **响应式设计**: 兼容所有设备（桌面、平板、手机）\n- **RTL支持**: 完整支持从右到左的语言\n- **易于集成**: 在网站任何地方使用短代码 `[product_recommendation_form]`\n\n#### 使用方法\n```php\n// 在页面或文章中\n[product_recommendation_form]\n\n// 在PHP模板中\necho do_shortcode('[product_recommendation_form]');\n\n// 使用自定义属性\n[product_recommendation_form title=\"找到您的完美产品\"]\n```\n\n#### 安装和设置\n1. 从发布页面下载插件ZIP文件\n2. 进入WordPress管理面板 → 插件 → 添加新插件\n3. 点击\"上传插件\"并选择下载的ZIP文件\n4. 点击\"立即安装\"然后\"激活插件\"\n\n### 🇷🇺 Russian / Русский\n\n#### Основные возможности\n- **Умный движок рекомендаций**: Продвинутый алгоритм для сопоставления предпочтений клиентов с характеристиками продуктов\n- **Интерактивная форма**: Динамическая анкета, которая направляет клиентов к их идеальным продуктам\n- **Настраиваемые вопросы**: Возможность добавлять, редактировать, удалять и переупорядочивать вопросы из панели администратора\n- **Многоязычная поддержка**: Полная поддержка персидского, английского, русского, китайского и арабского языков\n- **Адаптивный дизайн**: Совместимость со всеми устройствами (десктоп, планшет, мобильный)\n- **Поддержка RTL**: Полная поддержка языков справа налево\n- **Простая интеграция**: Использование шорткода `[product_recommendation_form]` в любом месте сайта\n\n#### Как использовать\n```php\n// В странице или записи\n[product_recommendation_form]\n\n// В PHP шаблоне\necho do_shortcode('[product_recommendation_form]');\n\n// С пользовательскими атрибутами\n[product_recommendation_form title=\"Найдите свой идеальный продукт\"]\n```\n\n#### Установка и настройка\n1. Скачайте ZIP файл плагина со страницы релизов\n2. Перейдите в панель управления WordPress → Плагины → Добавить новый\n3. Нажмите \"Загрузить плагин\" и выберите скачанный ZIP файл\n4. Нажмите \"Установить сейчас\" и затем \"Активировать плагин\"\n\n---\n\n## 🛠️ Development\n\n### Project Structure\n\n```\nproduct-recommendation/\n├── assets/\n│   ├── css/\n│   │   ├── admin.css\n│   │   └── style.css\n│   └── js/\n│       ├── admin.js\n│       └── script.js\n├── includes/\n│   ├── class-product-database.php\n│   ├── class-product-form.php\n│   ├── class-product-recommendation.php\n│   ├── class-product-recommendation-activator.php\n│   ├── class-product-recommendation-admin.php\n│   ├── class-product-recommendation-ajax.php\n│   ├── class-product-recommendation-deactivator.php\n│   ├── class-product-recommendation-engine.php\n│   ├── class-product-recommendation-frontend.php\n│   ├── class-product-recommendation-product.php\n│   └── class-product-recommendation-settings.php\n├── languages/\n│   ├── product-recommendation.pot\n│   └── [translation files]\n├── product-recommendation.php\n├── readme.txt\n└── uninstall.php\n```\n\n### Building for Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/nasserhaji/product-recommendation.git\n\n# Install development dependencies (if any)\ncomposer install\n\n# Run tests (if available)\nphpunit\n\n# Build for production\n# The plugin is ready to use as-is\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these steps:\n\n1. **Fork the repository**\n2. **Create a feature branch**: `git checkout -b feature/amazing-feature`\n3. **Make your changes**: Follow WordPress coding standards\n4. **Test thoroughly**: Ensure compatibility with WordPress and WooCommerce\n5. **Commit your changes**: `git commit -m 'Add amazing feature'`\n6. **Push to the branch**: `git push origin feature/amazing-feature`\n7. **Open a Pull Request**: Provide detailed description of changes\n\n### Coding Standards\n\n- Follow [WordPress Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/)\n- Use meaningful variable and function names\n- Add proper documentation for all functions\n- Include inline comments for complex logic\n- Test on multiple WordPress and WooCommerce versions\n\n## 📝 Changelog\n\n### [1.0.0] - 2024-01-XX\n\n#### Added\n- Initial release of Product Recommendation System\n- Smart product recommendation form with interactive questionnaire\n- Multi-language support (Persian, English, Russian, Chinese, Arabic)\n- Customizable questions and settings from admin panel\n- WooCommerce integration with product characteristics\n- Responsive design with RTL support\n- Admin management panel with comprehensive settings\n- AJAX-powered dynamic recommendations\n- Random product fallback system\n- Customizable styling options\n\n#### Features\n- Interactive recommendation form\n- Multi-language localization\n- Responsive design\n- WooCommerce integration\n- Admin management panel\n- Customizable styling\n- RTL language support\n\n## 📄 License\n\nThis project is licensed under the GPL v2 or later - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- **WordPress Community**: For the amazing platform\n- **WooCommerce Team**: For the excellent e-commerce solution\n- **Contributors**: Everyone who has contributed to this project\n- **Translators**: Community members who have provided translations\n\n## 📞 Support\n\n- **Documentation**: [GitHub Wiki](https://github.com/nasserhaji/product-recommendation/wiki)\n- **Issues**: [GitHub Issues](https://github.com/nasserhaji/product-recommendation/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/nasserhaji/product-recommendation/discussions)\n- **Author**: [Mohammad Nasser Haji Hashemabad](https://mohammadnasser.com/)\n\n## ⭐ Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=nasserhaji/product-recommendation\u0026type=Date)](https://star-history.com/#nasserhaji/product-recommendation\u0026Date)\n\n---\n\n**Made with ❤️ for the WordPress community** ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasserhaji%2Fproduct-recommendation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnasserhaji%2Fproduct-recommendation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasserhaji%2Fproduct-recommendation/lists"}