Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lancedesk/promotion_options
The Promotion Options plugin extends the functionality of the ClassiAds WordPress theme and DirectoryPress plugin by allowing users to add and manage promotion options for listings. It integrates with WooCommerce to handle promotional features in the cart and order details.
https://github.com/lancedesk/promotion_options
ajax javascript php php7 php8 wordpress wordpress-plugin
Last synced: about 1 month ago
JSON representation
The Promotion Options plugin extends the functionality of the ClassiAds WordPress theme and DirectoryPress plugin by allowing users to add and manage promotion options for listings. It integrates with WooCommerce to handle promotional features in the cart and order details.
- Host: GitHub
- URL: https://github.com/lancedesk/promotion_options
- Owner: lancedesk
- License: gpl-3.0
- Created: 2024-08-12T21:09:13.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-09-23T16:29:42.000Z (about 2 months ago)
- Last Synced: 2024-09-26T14:24:23.202Z (about 2 months ago)
- Topics: ajax, javascript, php, php7, php8, wordpress, wordpress-plugin
- Language: PHP
- Homepage: https://lancedesk.com
- Size: 125 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Promotion Options
A WordPress plugin designed to add and manage promotion options for listings. This plugin integrates with the ClassiAds theme, DirectoryPress, and WooCommerce to handle various promotional features for listings, including pricing and display on the frontend and in the cart.
## Description
The Promotion Options plugin extends the functionality of the ClassiAds WordPress theme and DirectoryPress plugin by allowing users to add and manage promotion options for listings. It integrates with WooCommerce to handle promotional features in the cart and order details.
## Features
- **Add Promotion Options**: Adds promotion options to the listing submission form.
- **Handle Promotion Options in Cart**: Integrates with WooCommerce to include promotion options in the cart.
- **Display Promotion Options**: Shows promotion options on the frontend and in the order details.
- **AJAX Handling**: Uses AJAX for marking listings as sold without page reloads.
- **Custom Post Types**: Utilizes custom post types for promotion options.
## Installation
1. **Upload the Plugin**: Upload the `promotion-options` plugin folder to your `/wp-content/plugins/` directory.
2. **Activate the Plugin**: Go to the WordPress admin panel, navigate to `Plugins`, and activate the "Promotion Options" plugin.
3. **Configure Settings**: Configure the settings as needed through the WordPress admin panel.
## Usage
1. **Add Promotion Options**: Use the plugin to add different promotion options to your listings.
2. **Submit Listings**: When submitting a listing, select the desired promotion options.
3. **View in Cart**: Promotion options will be displayed in the WooCommerce cart and checkout pages.
4. **Order Details**: Promotion options and charges will be visible in the order details.
## AJAX Handling
The plugin uses AJAX to mark a listing as sold:
- **Action Hook**: `mark_as_sold`
- **Parameters**: `listing_id`, `buyer_id`, `seller_id`
- **Response**: Success or error message.
## Plugin Files
- `includes/class-sales-manager.php`: Handles sales-related functions.
- `includes/class-promotion-handler.php`: Manages promotion options and pricing.
- `includes/class-cron-jobs.php`: Contains scheduled tasks.
- `includes/custom-post-type.php`: Defines custom post types for promotions.
- `includes/settings-page.php`: Manages plugin settings.
- `includes/helper-functions.php`: Provides utility functions.
- `includes/locations-ajax.php`: Handles AJAX requests for location-based features.
- `css/promotion-options.css`: Plugin styles.
- `js/promotion-options.js`: JavaScript for handling AJAX and frontend interactions.
## Example Code
### PHP
```php
/**
* Mark a listing as sold and record the sale in the database
*
* @param int $listing_id The ID of the listing
* @param int $buyer_id The ID of the buyer
* @param int $seller_id The ID of the seller
*/
public function mark_listing_as_sold($listing_id, $buyer_id, $seller_id)
{
global $wpdb;
$table_name = $wpdb->prefix . 'listing_sales';
$data = array(
'listing_id' => $listing_id,
'buyer_id' => $buyer_id,
'seller_id' => $seller_id,
'sale_date' => current_time('mysql')
);
return $wpdb->insert($table_name, $data);
}
```
## License
This plugin is licensed under the GPLv2 or later license.
## Author
Robert June - Lead Developer @ Lance Desk
## Support
For support, please contact [[email protected]](mailto:[email protected]) or open an issue on GitHub.