Docs: WP Desk Omnibus

How does it work?

The basic function of the plugin is to show the lowest price of the product and the date when it was valid.

Each change in the product price is saved in the table in the Omnibus Price History section as a new line or as a change to an existing entry.

The historical price table supports sorting, and the lowest prices in various currencies are highlighted in bold.

Product
Shows the product name and its ID. The plugin recognizes variants and shows them separately.
This parameter does not change when saving new prices.

Price
Shows the price.
This parameter does not change when saving new prices.

Currency
Shows the currency.
This parameter does not change when saving new prices.

Valid from
Shows the date and time the price was created. This is the moment from when the price was/is/will be valid. The date in Valid from is not the same as the date of saving the price e.g. if you save a promotional price with a schedule then this date will be the same as the future start date of the promotion schedule.
This parameter is changed when saving new prices only in certain exceptions (e.g. after deleting the promotional price schedule).

Valid to
Shows the price closing date and time. This is the moment until which the price was valid. The price with the Valid to date is closed and will never be edited again (dates will not be overwritten).
If Valid to is empty then the price is still valid (no new price has appeared to overwrite it) or the end of the promotion schedule has not been set.
This parameter is changed when saving new prices.

Price type
Shows the price type - Regular or Promotional.
This parameter does not change when saving new prices.

Examples of saving dates in Valid from/Valid to

Adding a regular price
A new row will appear in the table containing the regular price.
The Valid from date will be the same as the date on which the changes were saved.
The Valid to date will be empty.

Change of regular price
A new row will appear in the table containing the changed regular price.
The Valid from date will be the same as the date on which the changes were saved.
The Valid to date will be empty.
The previous regular price will be closed in the Valid to column on the date the changes were saved.

Adding a promotional price
A new row will appear in the table containing the promotional price.
The Valid from date will be the same as the date on which the changes were saved.
The Valid to date will be empty.
The last regular price will remain open (the Valid from and Valid to dates will not change).

Change of promotional price
A new row will appear in the table containing the changed promotional price.
The Valid from date will be the same as the date on which the changes were saved.
The Valid to date will be empty.
The previous promotional price will be closed in the Valid to column on the date the changes were saved.

Adding a promotional price with a schedule (past start date)
A new row will appear in the table containing the promotional price.
The date in Valid from will be the same as the date on which the changes were saved (Omnibus does not save dates backwards).
The Valid to date will be the same as the schedule closing date (if set) or blank.
The previous promotional price (if set) will be closed in the Valid to column with the date the changes were saved.

Adding a promotional price with a schedule (future start date)
A new row will appear in the table containing the promotional price.
The Valid from date will be the same as the schedule start date (if set) or the date when changes were saved.
The Valid to date will be the same as the schedule closing date (if set) or blank.
The previous promotional price (if set) will be closed in the Valid to column with the date the changes were saved.

Change of promotion schedule (without price change)
The new row will not appear in the table.
The Valid from and Valid to dates will be updated (if they have been changed).
The previous promotional price (if set) will remain closed (the Valid from and Valid to dates will not change).

Delete the schedule
The new row will not appear in the table.
The Valid from date will change from the schedule start date (if set) to the date the changes were saved.
The Valid to date will be deleted.

Requirements

The plugin from version 2.0.0 requires WooCommerce version 8.0.0.

First steps

The plugin does not require user intervention and works based on the initial settings.

Settings

Plugin settings are available in
WooCommerce > Settings > Products > General > Omnibus

Date interval
Set the range of days taken into account when determining the lowest price of the product.

Method of finding the lowest price

• Find the lowest price for product since current date
  Set this option so that the set Date interval is counted in relation to the current date.
• Find the lowest price since product's last promotion date
  Set this option so that the set Date interval is calculated in relation to the date of saving the latest promotional price (the latest promotional price will not be taken into account).

Current price is the lowest

• Display message as usual
  Enable this option to show the message even when the current price is the lowest price of the product.
• Don't display any message
  Enable this option so that the message is not shown when the current price is the lowest price of the product. The option will be useful e.g. when the price has not been changed for longer than in the set Date interval.

Display the lowest price only for promotional products
Check this option to make the plugin take into account only products with a set promotional price. The message with the lowest price will then not appear for products with a regular price.

Method of displaying message for product variations

• Display each product variant separately
  Set this option so that the message is shown when the user selects a specific variation from the list. The selected variation will be taken into account to calculate the lowest price.
• Show one, the lowest price from across all product's variants
  Set this option to show the message right after loading the page. All variations will be considered to calculate the lowest price.

Use sale prices
Check this option to make the plugin take into account promotional prices and not only regular prices.
The setting is not retroactive. If the promotional price was saved before enabling this setting - then it will not be taken into account. In this situation it is necessary to re-save the product with the sale price.
We do not recommend changing this setting frequently.

The lowest price message
The basic format will show the lowest price in the format:
The lowest price (date): price
Set your own format using available variables.
Example:
The lowest price from the last {days} days is {price} valid on {date}

Display message on product page
The drop-down list contains all available places to show the lowest price on the product subpage.
The default setting is Before product's meta data. This option allows to show the lowest price as the first item of product metadata.

Display message on archive page
The drop-down list contains all available places to show the lowest price on archive pages like:

• shop
• category
• tag
• attributes

The default setting is Do not display.

Display message on cart page
The drop-down list contains all available places to show the lowest price on the cart page.
The default setting is Do not display.

If your product prices are not being calculated correctly, verify prices again. You can do it by using Validate Prices button. Navigate to WooCommerce > Status > Tools wher you will find that button.

Support for Currency Conversion and Translations with WPML

Omnibus WooCommerce supports two types of currency conversions offered by WPML:
Manual addition of prices on product pages

To manually add a price in a currency other than the store's main currency, go to the product edit page and choose the WPML option Set prices in other currencies manually. After entering the price, save the changes, and the lowest prices in the added currency will be visible on the product page and in the table at the bottom of the product edit page.

Automatic Currency Conversion in Main Settings

To configure automatic conversion of prices for all products, go to the WooCommerce → WooCommerce Multilingual & Multicurrency → Multicurrency tab. Add the desired currencies and their exchange rates to the table, then save the changes. The new currencies will now be visible in your store, along with historical prices supported by the Omnibus WooCommerce plugin.

Notes on Currency Conversion Functionality

Omnibus, in integration mode with WPML, operates in two states depending on the method of price recording:

• Controlled Mode
  The user independently records prices in different currencies.
• Uncontrolled Mode
  Prices are automatically converted based on the exchange rate, and the user enters only one price for the product.

In uncontrolled mode, the recorded price in a foreign currency reflects the currency exchange rate at the time of conversion, even if this rate changes later. This is crucial for maintaining historical accuracy of prices, especially in the case of long-term currency exchange rate fluctuations.

Shortcodes

The plugin makes it possible to insert the lowest price or the full message about the lowest price in any place that supports adding shortcodes like subpages or post entries.

• [omnibus_price]
  Insert this shortcode to show the lowest price on the simple product subpage.
• [omnibus_price id="x"]
  Insert this shortcode to show the lowest price on other subpages e.g. on the variable product subpage. Replace x with the ID of a specific product or variation e.g. [omnibus_price id="123"]. You can find the product ID in the WP panel after hovering the cursor over the product name in the Products > All products tab.
• [omnibus_price_message]
  Insert this shortcode to show the full lowest price message on the simple product subpage. You can change the message text in The lowest price message setting.
• [omnibus_price_message id="x"]
  Insert this shortcode to show the full message about the lowest price on other subpages e.g. on the variable product subpage. Replace x with the ID of a specific product or variation e.g. [omnibus_price id="123"].

For advanced users

In the WP Desk Omnibus settings, there is an option called Display message on product pages and so on.

This option allows you to choose from a list of pre-defined action hooks that you can use to display the lowest price messages on your product pages. However, if you have a specific action hook that you would like to use, you can also enter the name of the hook directly in the field. Then you will be able to use this name as a reference for hook in your own code, which will display the message.

An example may be the following:

1. Set in display settings a value 'omnibus/custom/placement'.
2. Register your hook in your theme file:
   // page.php in your theme files
<article id="post-<?php the_ID(); ?>" <?php post_class( 'product' ); ?>>
<!-- Ommited for brevity... -->
<?php do_action( 'omnibus/custom/placement' ); ?>
</article><!-- #post-<?php the_ID(); ?> -->

If you are using this hook on some sort of landing pages, you can also explicitly specify product instance to get the lowest price from:

// home.php in your theme files
<header>
<!-- Ommited for brevity... -->
<?php
$product = wc_get_product( 14 ); // We want to use a product with ID 14 as a featured one.
do_action('omnibus/custom/placement', $product );
?>
</header>