Pre-Order Ultra

Pre-Order Ultra is a robust WooCommerce plugin that empowers store owners to manage pre-orders effortlessly. Whether you're launching a new product or handling out-of-stock inventory, Pre-Order Ultra offers the essential tools to capture customer interest and streamline your sales process.

Table of Contents

• Features
• Installation
• Configuration
• Usage
  • Setting Up Pre-Orders for New Products
  • Enabling Pre-Orders for Out-of-Stock Products
  • Notify Me When Available
• Shortcodes
• Templates
• Developer Documentation
  • API Endpoints
  • Hooks and Filters
• Changelog
• Frequently Asked Questions
• Support
• License

Features

• Pre-Order for New Product Launches:

  • Schedule product releases with specific availability dates.
  • Display countdown timers to create urgency and anticipation.
  • Allow customers to place pre-orders in advance of the official launch.

• Pre-Order for Out-of-Stock Products:

  • Enable customers to subscribe for notifications when out-of-stock products become available.
  • Manage subscriptions for both logged-in users and guests.
  • Automatically notify subscribers via email when products are restocked.

• Notify Me When Available:

  • Offer a "Notify Me" button on product pages.
  • Collect subscriber information securely.
  • Handle subscriptions through an intuitive admin interface.

• Customizable Notifications:

  • Send personalized emails to subscribers upon product availability.
  • Customize email templates to align with your brand's voice.

• Admin Management:

  • View and manage all pre-order and subscription data from the WordPress dashboard.
  • Export subscriber lists for marketing and analysis purposes.

• Flexible Pricing Options:

  • Apply different pricing strategies for pre-orders, including discounts or fixed pricing.

• Integration with Popular Plugins:

  • Seamlessly integrates with WooCommerce, Dokan, and Easy Digital Downloads (EDD).

Installation

1. Download the Plugin:

   • Download the latest version of Pre-Order Ultra from the WordPress Plugin Repository or your source.

2. Upload to WordPress:

   • Log in to your WordPress admin dashboard.
   • Navigate to Plugins > Add New.
   • Click on Upload Plugin and select the pre-order-ultra.zip file.
   • Click Install Now and then Activate the plugin.

3. Activate the Plugin:

   • Upon activation, the plugin will create necessary database tables and schedule cron events automatically.

Configuration

1. Global Settings:

   • Navigate to WooCommerce > Settings > Products > Pre-Order.
   • Enable Pre-Orders Globally: Toggle to enable or disable pre-order functionality across all products.
   • Automatically Enable Pre-Order for Out-of-Stock Products: Enable this to allow pre-orders automatically when products are out of stock.
   • Notification Settings: Configure email settings for subscriber notifications.

2. Product-Level Settings:

   • Edit a product in WooCommerce > Products.
   • Scroll down to the Pre-Order tab.
   • Enable Pre-Order: Check this box to enable pre-order for the specific product.
   • Set Release Date: Choose between "No Date" or "Set Date" and specify the availability date and time.
   • Pre-Order Pricing: Select your desired pricing strategy for pre-orders.
   • Notify Me When Available: Customize the "Notify Me" button and form settings.

Usage

Setting Up Pre-Orders for New Products

1. Create or Edit a Product:

   • Go to WooCommerce > Products and select a product to edit or add a new one.

2. Enable Pre-Order:

   • In the Pre-Order tab, check the Enable Pre-Order option.

3. Set Release Date:

   • Choose "Set Date" and select the desired release date and time using the date picker.
   • A countdown timer will appear on the product page, showing customers the time remaining until the product is available.

4. Configure Pre-Order Pricing:

   • Select a pricing strategy (e.g., fixed price, discount percentage) and set the corresponding values.

5. Save the Product:

   • Click Update or Publish to save your changes.

Enabling Pre-Orders for Out-of-Stock Products

1. Global Pre-Order Settings:

   • Ensure that Automatically Enable Pre-Order for Out-of-Stock Products is enabled in the global settings.

2. Manage Product Stock:

   • For products that are out of stock, pre-order options will automatically be available based on the global settings.

3. Notify Me When Available:

   • Customers can subscribe to be notified when the product is back in stock.

Notify Me When Available

1. Display the Notify Me Button:

   • On applicable product pages, the "Notify Me When Available" button will appear.

2. Subscription Process:

   • Logged-In Users:
     • Click the button to subscribe using their account information.
   • Guests:
     • Click the button to open a form where they can enter their Name, Email Address, and Phone Number.

3. Data Handling:

   • Subscriptions are stored securely in a custom database table.
   • Subscribers receive confirmation emails upon subscribing.

4. Notifications Upon Availability:

   • When the product becomes available, a cron job triggers and sends notifications to all subscribers.
   • Subscribers are informed via their preferred contact method that the product is now in stock.

Shortcodes

Currently, Pre-Order Ultra does not utilize shortcodes. Future updates may include shortcode support for greater flexibility.

Templates

Pre-Order Ultra includes customizable templates for the "Notify Me" form and pre-order notices. You can override these templates by copying them to your theme's WooCommerce folder.

Overriding Templates

1. Locate the Template:

   • Find the template file in pre-order-ultra/templates/notify-me-form.php.

2. Copy to Theme:

   • Copy the file to your theme's WooCommerce directory: your-theme/woocommerce/pre-order-ultra/notify-me-form.php.

3. Customize:

   • Modify the copied template as needed to match your site's design and functionality requirements.

Developer Documentation

API Endpoints

Pre-Order Ultra provides a set of REST API endpoints to manage subscriptions and notifications. Below are the key endpoints:

Base Namespace:

/wp-json/pre-order-ultra/v1/

Endpoints:

• Create Subscription

  • Method: POST
  • Route: /subscriptions
  • Description: Creates a new subscription for a product, either for logged-in users or guests.
  • Parameters:
    • name (string, required): The subscriber's name.
    • email (string, required): The subscriber's email.
    • phone_number (string, optional): The subscriber's phone number.
    • product_id (int, required): The product to subscribe to.

• Get Subscriptions by Product

  • Method: GET
  • Route: /subscriptions
  • Description: Retrieves active subscriptions for a specific product.
  • Parameters:
    • product_id (int, required): The ID of the product.

• Update Subscription

  • Method: PUT/PATCH
  • Route: /subscriptions/{id}
  • Description: Updates an existing subscription’s details such as name, email, or phone number.
  • Parameters:
    • name (string, optional): The updated name of the subscriber.
    • email (string, optional): The updated email of the subscriber.
    • phone_number (string, optional): The updated phone number of the subscriber.

• Delete Subscription

  • Method: DELETE
  • Route: /subscriptions/{id}
  • Description: Marks a subscription as deleted.

• Mark Subscription as Notified

  • Method: PUT/PATCH
  • Route: /subscriptions/{id}/mark-notified
  • Description: Marks a subscription as "notified" when the product becomes available.

• Bulk Mark Subscriptions as Notified

  • Method: POST
  • Route: /subscriptions/bulk-mark-notified
  • Description: Marks multiple subscriptions as "notified."
  • Parameters:
    • ids (array, required): List of subscription IDs to mark as notified.

• Unsubscribe

  • Method: DELETE
  • Route: /subscriptions/unsubscribe
  • Description: Allows users to unsubscribe from a product by providing their email and product ID.
  • Parameters:
    • email (string, required): The email of the subscriber.
    • product_id (int, required): The product ID to unsubscribe from.

• Get Subscription Statistics

  • Method: GET
  • Route: /subscriptions/statistics
  • Description: Retrieves statistics for all subscriptions, including totals for active, notified, and deleted subscriptions.

Hooks and Filters

Pre-Order Ultra utilizes several WordPress and WooCommerce hooks and filters to extend functionality. Below are some key hooks you can leverage:

• Actions:

  • pre_order_ultra_init: Fires on plugin initialization.
  • pre_order_ultra_notify_me_submission: Fires when a user submits the "Notify Me" form.
  • pre_order_ultra_product_restocked: Fires when a product's stock status changes to "In Stock."
  • pre_order_ultra_send_notifications: Cron event to send notifications.

• Filters:

  • pre_order_ultra_add_to_cart_text: Modify the "Add to Cart" button text for pre-order products.
  • pre_order_ultra_price_html: Adjust product price display for pre-orders.

Extending Functionality

Developers can extend Pre-Order Ultra by hooking into its actions and filters or by utilizing its classes:

• Adding Custom Notification Methods:

  • Extend the Subscription_Manager class to integrate with additional notification channels.

• Customizing the Notify Me Form:

  • Override the template file to add or remove fields based on your requirements.

• Integrating with Third-Party Services:

  • Use the API endpoints to connect Pre-Order Ultra with external systems or services.

Changelog

[1.0.0] - 2024-04-27

• Initial release of Pre-Order Ultra.
• Features:
  • Pre-order for new product launches with release dates and countdown timers.
  • Pre-order for out-of-stock products with "Notify Me When Available" functionality.
  • Admin interface for managing pre-orders and subscriptions.
  • Email notifications to subscribers upon product availability.
  • Integration with WooCommerce, Dokan, and Easy Digital Downloads (EDD).

[1.1.0] - 2024-10-24

• Refactored plugin architecture for better maintainability.
• Moved table creation and activation hooks to the main plugin class.
• Enhanced "Notify Me When Available" feature with guest subscription support.
• Added admin interface for managing subscriptions.
• Implemented cron job handling within a dedicated class.
• Improved security measures with nonce validations and data sanitization.
• Enhanced frontend scripts and styles for better user experience.

Frequently Asked Questions

1. Can I customize the notification emails?

Yes, Pre-Order Ultra allows you to customize email templates to match your brand's voice and messaging needs.

2. Does the plugin support variable products?

Yes, you can enable pre-orders for variable products. Each variation can have its own pre-order settings.

3. How are guest subscriptions handled?

Guests can subscribe by providing their Name, Email Address, and optionally Phone Number. Their information is securely stored and used for notifications.

4. Is there a limit to the number of pre-orders I can receive?

Pre-Order Ultra does not impose any limits on the number of pre-orders or subscriptions. However, performance may vary based on your hosting environment.

5. How do I export subscriber data?

Subscribers can be viewed and exported from the admin interface under WooCommerce > Pre-Order Subscriptions.

Support

If you encounter any issues or have questions about Pre-Order Ultra, please reach out to our support team:

• Email: support@preorderultra.com
• Support Forum: WordPress.org Support
• Documentation: Available within the plugin and on our official website.

License

Pre-Order Ultra is licensed under the GNU General Public License v2.0 or later.