{"id":22567825,"url":"https://github.com/lonsdale201/simple-loyalty-program","last_synced_at":"2026-02-16T10:16:16.722Z","repository":{"id":263415274,"uuid":"890093818","full_name":"Lonsdale201/Simple-Loyalty-Program","owner":"Lonsdale201","description":"This is a WooCommerce extension that adds loyalty program functionality.","archived":false,"fork":false,"pushed_at":"2025-01-01T22:18:53.000Z","size":187,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T22:14:24.350Z","etag":null,"topics":["woocommerce","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Lonsdale201.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-18T01:08:28.000Z","updated_at":"2025-01-17T04:53:36.000Z","dependencies_parsed_at":"2024-11-18T12:55:16.733Z","dependency_job_id":"05494a21-b328-475d-906a-1df845e5c2a5","html_url":"https://github.com/Lonsdale201/Simple-Loyalty-Program","commit_stats":null,"previous_names":["lonsdale201/simple-loyalty-program"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lonsdale201%2FSimple-Loyalty-Program","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lonsdale201%2FSimple-Loyalty-Program/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lonsdale201%2FSimple-Loyalty-Program/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lonsdale201%2FSimple-Loyalty-Program/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lonsdale201","download_url":"https://codeload.github.com/Lonsdale201/Simple-Loyalty-Program/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248119290,"owners_count":21050755,"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":["woocommerce","wordpress","wordpress-plugin"],"created_at":"2024-12-08T00:09:19.709Z","updated_at":"2026-02-16T10:16:16.631Z","avatar_url":"https://github.com/Lonsdale201.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Loyalty Program for WooCommerce\nStable tag: 1.1.0\n\nThis plugin adds customizable loyalty features to WooCommerce, offering various settings for a tailored experience.\n\n\n\u003e [!IMPORTANT]\n\u003e Minimum PHP version: 8.0\n\n\u003e [!IMPORTANT]\n\u003e Minimum WordPress version: 6.0\n\n\u003e [!IMPORTANT]\n\u003e Minimum WooCommerce version: 9.0.0\n\n\n\u003e [!CAUTION]\n\u003e To use this plugin you need the WooCommerce plugin!\n\n## INSTRUCTIONS\n\n**How to download?**\n\nIn the right section the green button: **\u003c\u003eCode** click, and in the dropdown menu, select the **Download ZIP** option. The downloaded file just upload it, you can easily install the downloaded file as an plugin within wordpress.\n\n**Important Note**: The plugin includes a periodic (time-based) discount system. However, this system operates independently from the loyalty program and cannot be used simultaneously. You must choose between using the periodic discount or the loyalty program.\n\n---\n\n## Key Features\n\n- **Periodic Discounts**\n- **Loyalty Discounts**\n- **Free Gift Products**\n- **Exclusion Options**\n- **FluentCRM Integration**\n- **Notification Options**\n- **Inactivity Rules**\n- **Free Shipping**\n\n---\n\n## How the Loyalty Program Works\n\nUsers are added to the loyalty program when they meet the criteria during a **successful purchase**. The criteria include minimum spending amount, minimum items purchased, and/or user roles. These are evaluated only when an order is completed successfully.\n\n### Stored Data:\n- Loyalty status.\n- Last activity date.\n- Joining date.\n- Total spent amount.\n- Total item count.\n\nAll this data is saved in the user's meta information and used exclusively by the plugin. You can modify a user’s loyalty status directly via the **Admin User Menu** at any time.\n\n---\n\n## Discount System\n\nThe plugin provides two types of discounts based on cart contents:\n\n1. **Percentage-Based Discount**  \n2. **Fixed Amount Discount**\n\n### Exclusion Options:\n- Discounts can be disabled for carts containing sale items.\n- Coupons can optionally be disabled when a discount is applied.\n\n### Loyalty Discounts:\n- Define criteria for a user to qualify for the loyalty program:\n  - Minimum spending amount.\n  - Minimum purchased items.\n  - User roles.\n\n- Customize the relationship between the criteria:\n  - Require at least one condition to be met, or all conditions.\n\n- Automatically assign one or more free gift products to loyalty customers.\n\n---\n\n## Periodic Discount System\n\nThis mode offers flexibility with two key options:\n- **Target Amount**: Specify the spending threshold that users must reach.\n- **Time Frame**: Define the retrospective time period to be considered.\n\n**How it works:**  \nUsers must spend the target amount within the defined time frame to qualify for discounts.\n\n---\n\n## Additional Features\n\n- Create a custom **\"My Account\"** menu item for loyalty customers.\n- Provide detailed information about the program, including dynamic updates using **smartcodes** for real-time data.\n\n---\n\n## Developer Support\n\nFilters and actions are available for advanced customizations. Detailed documentation on these can be found in the **Wiki** section of this repository.\n\n---\n\n## Roadmap\n\n- [ ] **Rechecker Implementation**: Automate checks for updated eligibility.\n- [ ] **Email Notifications**: Notify users about loyalty status or discounts.\n- [ ] **Dynamic Shortcodes**: Display live data for advanced customization.\n\n## CHANGELOG\n\n### V 1.1 *2024.12.18*\n\n* The inactivity system did not respect the unique purchase amount and item values (provided by the plugin), and deleted them even if they were not enabled. Fixed\n* **New** feature for loyal customers! \n\n**Free Shipping option**\nYou can now make **free shipping** to loyal customers. \nCreate a free shipping method and select the Loyalty program member option in the requirements field.\nYou can also combine it with woocommerce's *minimum order amount* setting, because it takes into account.\n\n### V 1.0 *2024.11.18.*\n\n* Initial release\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flonsdale201%2Fsimple-loyalty-program","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flonsdale201%2Fsimple-loyalty-program","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flonsdale201%2Fsimple-loyalty-program/lists"}