{"id":19639466,"url":"https://github.com/robertdevore/gift-cards-for-woocommerce","last_synced_at":"2025-04-28T10:31:04.440Z","repository":{"id":261776001,"uuid":"882963476","full_name":"robertdevore/gift-cards-for-woocommerce","owner":"robertdevore","description":"Add robust gift card functionality to your WooCommerce® powered store","archived":false,"fork":false,"pushed_at":"2025-01-03T20:05:08.000Z","size":263,"stargazers_count":21,"open_issues_count":3,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-05T08:22:49.185Z","etag":null,"topics":["woocommerce","woocommerce-plugin","wordpress"],"latest_commit_sha":null,"homepage":"https://robertdevore.com/introducing-gift-cards-for-woocommerce-free/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robertdevore.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-04T06:03:49.000Z","updated_at":"2025-01-03T20:05:12.000Z","dependencies_parsed_at":"2024-11-08T11:49:15.265Z","dependency_job_id":null,"html_url":"https://github.com/robertdevore/gift-cards-for-woocommerce","commit_stats":null,"previous_names":["robertdevore/gift-cards-for-woocommerce"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdevore%2Fgift-cards-for-woocommerce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdevore%2Fgift-cards-for-woocommerce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdevore%2Fgift-cards-for-woocommerce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdevore%2Fgift-cards-for-woocommerce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robertdevore","download_url":"https://codeload.github.com/robertdevore/gift-cards-for-woocommerce/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251295236,"owners_count":21566424,"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","woocommerce-plugin","wordpress"],"created_at":"2024-11-11T13:01:04.194Z","updated_at":"2025-04-28T10:31:04.432Z","avatar_url":"https://github.com/robertdevore.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gift Cards for WooCommerce® (free)\n\n**Gift Cards for WooCommerce®** is a comprehensive plugin that adds robust gift card functionality to your WooCommerce® store. Empower your customers to purchase, send, and redeem gift cards effortlessly, enhancing their shopping experience and boosting your sales.\n\nThis plugin seamlessly integrates with WooCommerce®, providing both admin and customer-facing features to manage gift cards effectively. Whether you're running a small boutique or a large online store, this plugin offers the flexibility and tools you need to handle gift cards with ease.\n\n## Features\n\n- **Admin Management:**\n\n    - Create, edit, and delete gift cards directly from the WooCommerce® admin dashboard.\n    - View a comprehensive list of all gift cards with details such as code, balance, recipient email, issuance date, and expiration date.\n    - Import and export gift cards in bulk using CSV files.\n    - Log all gift card activities, including creation, usage, balance adjustments, and deletions.\n    - Schedule automated emails for gift card delivery and expiration reminders.\n- **Customer Experience:**\n\n    - Customers can purchase gift cards as standalone products or as variations of existing products.\n    - Option to send gift cards directly via email with personalized messages.\n    - Manage and view active gift cards from the \"My Account\" section.\n    - Apply gift card balances during checkout for discounts.\n- **Integration:**\n\n    - Seamlessly integrates with WooCommerce®'s cart and checkout processes.\n    - Adds custom fields to products to mark them as gift cards.\n    - Supports both digital and physical gift cards.\n- **Customization:**\n\n    - Customize email templates for gift card delivery and reminders.\n    - Set expiration dates and reminder periods for gift cards.\n\n## Installation\n\nFollow these steps to install and activate the **Gift Cards for WooCommerce®** plugin:\n\n1. **Download the Plugin:**\n\n    - Clone the repository or download the latest release from [GitHub](https://github.com/robertdevore/gift-cards-for-woocommerce/).\n2. **Upload to WordPress:**\n\n    - Navigate to your WordPress dashboard.\n    - Go to `Plugins` \u003e `Add New` \u003e `Upload Plugin`.\n    - Click on `Choose File` and select the downloaded `.zip` file.\n    - Click `Install Now`.\n3. **Activate the Plugin:**\n\n    - After installation, click `Activate Plugin`.\n    - Ensure that WooCommerce® is active. If not, activate WooCommerce® first as this plugin depends on it.\n4. **Initial Setup:**\n\n    - Upon activation, the plugin will create necessary database tables.\n    - Navigate to `WooCommerce` \u003e `Gift Cards` to access the plugin's admin interface.\n\n## Usage\n\n### Admin Dashboard\n\nOnce activated, the plugin adds a new submenu under the WooCommerce® menu in your WordPress admin dashboard.\n\n- **Accessing Gift Cards:**\n    - Go to `WooCommerce` \u003e `Gift Cards` to access the main management interface.\n- **Tabs Overview:**\n    - **Gift Cards:** View and manage all existing gift cards.\n    - **Activity:** Monitor all gift card-related activities, including creation, usage, and adjustments.\n    - **Add Card:** Issue new gift cards manually.\n    - **Settings:** Customize email templates and set reminder periods for expiring gift cards.\n\n### Managing Gift Cards\n\n- **Viewing Gift Cards:**\n\n    - The \"Gift Cards\" tab displays a list of all gift cards with details like code, balance, recipient email, issued date, and expiration date.\n    - Use the search bar and filter options to locate specific gift cards.\n- **Editing Gift Cards:**\n\n    - Click the **Edit** button next to a gift card to modify its details.\n    - A modal window will appear where you can update the balance, expiration date, recipient email, sender name, and personal message.\n    - Upon successful submission, a success message will display within the modal.\n- **Deleting Gift Cards:**\n\n    - Click the **Delete** button next to a gift card to remove it.\n    - A confirmation prompt ensures that you intend to delete the gift card.\n\n### Importing and Exporting Gift Cards\n\n- **Exporting Gift Cards:**\n    - Navigate to the \"Gift Cards\" tab.\n    - Click on the `Export CSV` button to download a CSV file containing all gift card data.\n- **Importing Gift Cards:**\n    - Click on the `Import CSV` button.\n    - Select a valid CSV file containing gift card data.\n    - The plugin will process the file and import the gift cards in batches to ensure performance.\n    - Upon completion, a success or error message will display.\n\n### Integrating Gift Cards with Products\n\n- **Marking Products as Gift Cards:**\n\n    - Edit a product in WooCommerce®.\n    - In the \"Product Data\" section, check the **Gift Card** option to mark the product as a gift card.\n    - For variable products, predefined gift card amounts (e.g., $25, $50, $100) are automatically generated as variations.\n- **Gift Card Fields on Product Pages:**\n\n    - On the frontend, gift card products display additional fields for:\n        - **Gift Card Type:** Digital or Physical.\n        - **Recipient Email:** Email address of the gift card recipient.\n        - **Sender Name:** Name of the sender.\n        - **Message:** Personalized message for the recipient.\n        - **Delivery Date:** Date when the gift card should be delivered.\n\n### Customer Experience\n\n- **Purchasing Gift Cards:**\n\n    - Customers can add gift card products to their cart and proceed to checkout.\n    - During checkout, they can apply gift card codes to avail discounts based on their gift card balances.\n- **Managing Gift Cards:**\n\n    - After logging into their account, customers can navigate to the `Gift Cards` section under \"My Account.\"\n    - Here, they can view all active gift cards, their balances, and expiration dates.\n\n### Additional Features\n\n- **Scheduled Emails:**\n\n    - The plugin schedules daily events to send out gift card delivery emails and expiration reminders.\n    - Customize email templates and set the number of days before expiration to receive reminders in the \"Settings\" tab.\n- **Activity Logs:**\n\n    - Monitor all actions related to gift cards in the \"Activity\" tab, including creation, usage, balance adjustments, and deletions.\n\n## Frequently Asked Questions (FAQ)\n\n**Q: Does this plugin support both digital and physical gift cards?**  \n**A:** Yes, the plugin allows you to create both digital and physical gift cards. You can specify the type when issuing a gift card.\n\n**Q: Can I customize the email templates sent to recipients?**  \n**A:** Absolutely! Navigate to the \"Settings\" tab in the Gift Cards admin page to customize the email templates, including adding custom images and text.\n\n**Q: How does the import/export functionality work?**  \n**A:** You can export all gift card data as a CSV file for backup or migration purposes. Similarly, you can import gift cards in bulk by uploading a properly formatted CSV file. The plugin processes imports and exports in batches to optimize performance.\n\n**Q: Are there any user role restrictions?**  \n**A:** Only users with the `manage_woocommerce` capability can manage gift cards. This ensures that only authorized personnel can create, edit, or delete gift cards.\n\n**Q: How are gift card balances managed and updated?**  \n**A:** Gift card balances are automatically updated based on usage during checkout. Admins can also manually adjust balances through the edit modal in the admin dashboard.\n\n**Q: What happens if a gift card expires?**  \n**A:** The plugin can be configured to send reminder emails a specified number of days before a gift card expires. Expired gift cards are no longer usable for discounts.\n\n## Contributing\n\nContributions are always welcome! If you'd like to contribute to the free **Gift Cards for WooCommerce®** plugin, please follow these steps:\n\n1. **Fork the Repository:**\n\n    - Click the `Fork` button on the top right of the repository page.\n2. **Clone Your Fork:**\n    ```\n    git clone https://github.com/your-username/gift-cards-for-woocommerce.git\n    ```\n\n3. **Create a New Branch:**\n    ```\n    git checkout -b feature/your-feature-name\n    ```\n\n4. **Make Your Changes:**\n\n    - Implement your feature or fix.\n5. **Commit Your Changes:**\n    ```\n    git commit -m \"Add feature: Your Feature Description\"\n    ```\n\n6. **Push to Your Fork:**\n    ```\n    git push origin feature/your-feature-name\n    ```\n\n7. **Submit a Pull Request:**\n\n    - Navigate to the original repository and click `New Pull Request`.\n    - Provide a clear description of your changes.\n\n## License\n\nThis plugin is licensed under the [GPL-2.0+ License](http://www.gnu.org/licenses/gpl-2.0.txt). You may not remove this notice or any other from the source code.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertdevore%2Fgift-cards-for-woocommerce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobertdevore%2Fgift-cards-for-woocommerce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertdevore%2Fgift-cards-for-woocommerce/lists"}