Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/openedx/openedx-wordpress-ecommerce
You can sell your Open edX courses with WooCommerce using this free and open-source WordPress plugin.
https://github.com/openedx/openedx-wordpress-ecommerce
openedx opensource woocommerce
Last synced: about 1 month ago
JSON representation
You can sell your Open edX courses with WooCommerce using this free and open-source WordPress plugin.
- Host: GitHub
- URL: https://github.com/openedx/openedx-wordpress-ecommerce
- Owner: openedx
- License: gpl-2.0
- Created: 2023-06-05T21:25:23.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-28T15:38:00.000Z (4 months ago)
- Last Synced: 2024-08-28T17:19:44.904Z (4 months ago)
- Topics: openedx, opensource, woocommerce
- Language: PHP
- Homepage: https://docs.openedx.org/projects/wordpress-ecommerce-plugin/en/latest/index.html
- Size: 1.68 MB
- Stars: 10
- Watchers: 5
- Forks: 7
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# ⭐ Open edX Commerce (WordPress Plugin)
The "Open edX Commerce" package is a free and open-source WordPress plugin that allows you to integrate WooCommerce with your Open edX platform.
**What does this mean?**
You can create Open edX courses as products in WooCommerce, and when you perform purchase or refund operations for these products, your Open edX platform will reflect these changes.
Here are some things you can do with this plugin:
- **Create Open edX courses as products:** When you create products using WooCommerce, you can designate them as Open edX courses. If you do, you can assign the course mode and course_id you registered in your Open edX platform.
- **Add settings for the connection with Open edX:** You'll have a new option in your WordPress settings to store authentication-related information for your Open edX platform.
- **Enrollment Manager:** You'll have a table that records all enrollment requests made through purchasing products that are Open edX courses.
- **View the enrollment requests from the orders:** When a person purchases WordPress, a WooCommerce order is generated. If an order includes a product that is an Open edX course, you can easily access the related enrollment request created with this plugin.
- **Create enrollments in Open edX:** When an order containing an Open edX course is processed, it automatically creates an enrollment request.
- You can also include the option to apply the "force" flag, disregarding the course's enrollment end dates.
- Starting from version Quince of Open edX, you can use the option to create enrollment allowed for non-registered users on the platform.
- **Create soft unenrollments from refunds:** The enrollment record is maintained, but the "is_active" attribute of the enrollment is false. Deleting an "enrollment allowed" is also supported, but only from version Quince.
- **Obtain enrollment information:** This requests the Open edX APIs to retrieve the enrollment status of a user in a course.
**Note**
This plugin calls the APIs from Open edX Platform.
More information about the API connection can be found in Decisions: API connection.
To learn more, you can visit the Open edX Terms of Service.
# Installation
## Requirements
- PHP 8.0 or greater is recommended
- Wordpress 6.3.1
- [WooCommerce plugin.](https://wordpress.org/plugins/woocommerce)
## Manual installation
1. Download the ZIP version on [the release page in the GitHub repository](https://github.com/openedx/openedx-wordpress-ecommerce/releases).
2. Log in to your WordPress admin dashboard, navigate to the Plugins menu in the sidebar and click **Add New**.
3. Upload the ZIP version of this project.
4. Activate the plugin.
# Getting Started
Let's start installing and configuring the Open edx Commerce plugin to connect your WordPress site with the enrollment APIs from your Open edX platform.
[Link to the Quickstart in the documentation.](https://github.com/openedx/openedx-wordpress-ecommerce/blob/main/docs/source/plugin_quickstart.rst)
# Open edX Compatibility
- Tested from Olive
**NOTE:** Enrollment of users who are not platform users (Create course enrollment allowed) is only supported for versions equal to or after Quince.
# Getting Help
To report a bug or request a feature, visit [issues](https://github.com/openedx/openedx-wordpress-ecommerce/issues).
## Documentation
See [documentation on Read the Docs](https://docs.openedx.org/projects/wordpress-ecommerce-plugin/en/latest/index.html).
# How to Contribute
Contributions are very welcome. Please read [How To Contribute](https://openedx.atlassian.net/wiki/spaces/COMM/pages/941457737/How+to+Start+Contributing+Code) for details.
This project accepts all contributions, bug fixes, security fixes, maintenance work, or new features. However, please discuss your new feature idea with the maintainers before beginning development to maximize the chances of accepting your change. You can start a conversation by creating a new issue on this repo summarizing your idea.
# License
The code in this repository is licensed under version 2 of the GNU General Public License. Please see the [LICENSE](LICENSE.txt) file for details.