Limbus Happy Hours for WooCommerce lets store managers run time-limited \"happy hour\" promotions without touching product prices.<\/p>\n\n
A campaign applies a percentage discount to the product categories you choose, for the period you choose. When it ends, prices go back on their own.<\/p>\n\n
[lhhw_banner]<\/code> shortcode, with desktop and mobile images.<\/li>\n- Category pages: banner and countdown at the top of the running campaign's categories. Categories you mark as dedicated to happy hours can be closed the rest of the time, showing a message and a countdown to the next session instead of products.<\/li>\n<\/ul>\n\n
Notify me<\/h4>\n\n\n- A \"Notify me of the next happy hours\" link or e-mail form, during and outside campaigns, on dedicated category pages or anywhere through
[lhhw_notify]<\/code>.<\/li>\n- Subscribers tab with search, campaign filter, CSV export, and the WordPress personal data export and erasure tools.<\/li>\n<\/ul>\n\n
Sales statistics<\/h4>\n\n\n- Per campaign: orders, items sold, happy hour revenue, order revenue, total discount, average order value and customers, tax included.<\/li>\n
- Products sorted by quantity or amount, customers sorted by date or amount, and a breakdown per session for recurring campaigns.<\/li>\n
- Paid orders only, refunds deducted.<\/li>\n<\/ul>\n\n
Privacy<\/h4>\n\n
This plugin does not connect to any external service and does not track visitors. Subscriber e-mail addresses are stored in a table of your own database, and can be exported or erased with the WordPress privacy tools under Tools > Export \/ Erase personal data. A salted hash of the visitor IP address is kept for ten minutes to limit abusive form submissions; the address itself is never stored. Settings, campaigns and subscribers are kept when the plugin is deleted, unless you tick \"Delete subscribers and settings when the plugin is deleted\".<\/p>\n\n
Simple, variable and external products are supported.<\/p>\n\n\n
\n- Upload the plugin through Plugins > Add New > Upload Plugin, then activate it. WooCommerce must be active.<\/li>\n
- Go to WooCommerce > Happy Hours and click \"New campaign\".<\/li>\n
- Name the campaign, set the schedule, the discount and the categories, then configure the popup and the banner.<\/li>\n
- Paste the
[lhhw_banner]<\/code> shortcode where the banner should appear, for example on the home page. The same shortcode always displays the banner of whichever campaign is running.<\/li>\n- Use the \"Preview\" link to check a campaign before its start time.<\/li>\n
- Display settings shared by every campaign \u2014 texts, colour, category pages, the \"notify me\" button \u2014 are in the \"Settings\" tab.<\/li>\n<\/ol>\n\n\n
\nWhich shortcodes are available?<\/h3><\/dt>\n[lhhw_banner] displays the banner or slider. Attributes: countdown=\"overlay|below|none\"<\/code> and class=\"my-class\"<\/code>.<\/p>\n\n[lhhw_countdown] displays the countdown on its own. Attributes: `style=\"inline|boxes\"` and `label=\"yes|no\"`.\n\n[lhhw_product_badge] places the product label manually, in an Elementor or theme template. Attribute: `id=\"123\"`.\n\n[lhhw_notify] displays the \"notify me\" link or form. Attribute: `mode=\"form|link\"`.\n<\/code><\/pre>\n\nThey output nothing outside a happy hour.<\/p><\/dd>\n
How do recurring campaigns work?<\/h3><\/dt>\nChoose \"Every day\", \"Days of the week\" or \"Days of the month\", the first date and the time of each session, the duration (24 hours maximum) and an optional end date. Each session starts and ends on its own. When a chosen day does not exist in a month, the session takes place on the last day of that month. Campaign statistics show the totals and a breakdown per session.<\/p><\/dd>\n
How do several campaigns work together?<\/h3><\/dt>\nOnly one campaign applies at a time: the running one. When none is running, the next scheduled campaign is used for the \"starts in\" displays. If two schedules overlap, the campaign that started last applies during the overlap, and the campaign list says so. Archived campaigns never run.<\/p><\/dd>\n
How are campaign statistics calculated?<\/h3><\/dt>\nWhen an order is placed, in classic or block checkout, each line sold at the happy hour price is tagged with the campaign, the price without the discount, the happy hour price and the discount, tax included. Statistics count paid orders (processing and completed) and deduct refunds. For orders placed before version 1.7, which carry no tag, the figures are estimated from the campaign categories and time slot, and are clearly flagged as estimates.<\/p><\/dd>\n
Does the happy hour start exactly on time?<\/h3><\/dt>\nPrices switch at the exact second. Emptying the page cache relies on WP-Cron, which runs on site visits. On a low-traffic site, set up a real server cron calling wp-cron.php every minute.<\/p><\/dd>\n
I use a CDN or a server cache (Cloudflare APO, Varnish).<\/h3><\/dt>\nEmpty it when a session starts and ends, by hooking onto lhhw_happy_hour_start<\/code>, lhhw_happy_hour_end<\/code> or lhhw_purge_caches<\/code>.<\/p><\/dd>\nWhy don't happy hour products appear in the native \"On sale products\" block?<\/h3><\/dt>\nWooCommerce builds that list from the database, and happy hour prices are calculated on the fly. Use [products category=\"your-category\"]<\/code> instead.<\/p><\/dd>\nMy theme hides the WooCommerce price in product lists.<\/h3><\/dt>\nThe label is moved below the product title automatically when the theme hides the price. You can also choose \"Below the title\" for product lists, or place [lhhw_product_badge]<\/code> in an Elementor or theme template.<\/p><\/dd>\nHow do category pages work with my theme?<\/h3><\/dt>\nDuring a campaign, the banner is shown on the pages of its categories. Outside campaigns, the pages of the categories ticked as dedicated show your message instead of products. The banner or the message is inserted with the standard WooCommerce hooks on classic themes, before the Product Collection block on block themes, and in JavaScript before the product grid for page builders.<\/p><\/dd>\n
Where are subscribers stored?<\/h3><\/dt>\nIn a table of your own database: e-mail, campaign name, context, page and date. They can be exported to CSV, deleted from the list, and are handled by the WordPress personal data export and erasure tools. The form is protected by a honeypot and a rate limit.<\/p><\/dd>\n
Can I send subscribers to my e-mailing tool?<\/h3><\/dt>\nUse the lhhw_subscriber_added<\/code> action (e-mail, data) to push new subscribers to your own tool, or import the CSV export.<\/p><\/dd>\nAt which width are mobile images used?<\/h3><\/dt>\nUp to 767 px, Elementor's default mobile breakpoint. Change it with the lhhw_mobile_breakpoint<\/code> filter.<\/p><\/dd>\nWhat happens to my settings when updating from 1.5?<\/h3><\/dt>\nThe schedule, discount, categories, popup and banner saved in version 1.5 are converted into a first campaign automatically. If products were hidden outside the happy hour, the offer categories become the dedicated categories.<\/p><\/dd>\n
Developer hooks<\/h3><\/dt>\nFilters: lhhw_is_active<\/code>, lhhw_current_campaign<\/code>, lhhw_product_in_scope<\/code>, lhhw_happy_price<\/code>, lhhw_link_url<\/code>, lhhw_show_popup<\/code>, lhhw_mobile_breakpoint<\/code>, lhhw_title_selector<\/code>, lhhw_category_mode<\/code>, lhhw_subscribe_rate_limit<\/code>, lhhw_csv_separator<\/code>, lhhw_stats_order_statuses<\/code>.<\/p>\n\nActions: lhhw_happy_hour_start<\/code> and lhhw_happy_hour_end<\/code> (campaign ID as parameter), lhhw_purge_caches<\/code>, lhhw_subscriber_added<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n\n1.9.3<\/h4>\n\n\n- Every shortcode and filter escapes the markup it returns, with an allowed list of tags, exactly like the markup the plugin prints itself.<\/li>\n<\/ul>\n\n
1.9.2<\/h4>\n\n\n- The subscription endpoint now requires a nonce. The form asks for a fresh one when it is submitted, so it keeps working on cached pages.<\/li>\n<\/ul>\n\n
1.9.1<\/h4>\n\n\n- Shortcodes are registered under their prefixed names only:
[lhhw_banner]<\/code>, [lhhw_countdown]<\/code>, [lhhw_product_badge]<\/code>, [lhhw_notify]<\/code>.<\/li>\n- Hardened output escaping and input sanitizing of the subscription endpoint.<\/li>\n
- When data deletion is enabled, uninstalling also removes archived campaigns.<\/li>\n<\/ul>\n\n
1.9.0<\/h4>\n\n\n- Renamed to Limbus Happy Hours for WooCommerce.<\/li>\n
- The interface is now in English and fully translatable; translations are managed on translate.wordpress.org.<\/li>\n
- Prefixed shortcodes:
[lhhw_banner]<\/code>, [lhhw_countdown]<\/code>, [lhhw_product_badge]<\/code>, [lhhw_notify]<\/code>.<\/li>\n- The recurrence summary in the campaign form now uses the weekday names of the site language.<\/li>\n<\/ul>\n\n
1.8.0<\/h4>\n\n\n- Recurring campaigns: every day, selected days of the week, selected days of the month, with an optional end date.<\/li>\n
- Live schedule summary and list of the next sessions in the campaign form.<\/li>\n
- Campaign list and statistics show the recurrence rule, the current or next session and the period.<\/li>\n
- Statistics: breakdown per session, sortable by date or revenue.<\/li>\n
- Scheduled tasks are rescheduled after each session; overlap detection covers the next 60 days.<\/li>\n<\/ul>\n\n
1.7.0<\/h4>\n\n\n- Campaign statistics: orders, items sold, happy hour revenue, order revenue, total discount, average order value, customers.<\/li>\n
- Products sold per campaign and customers per campaign, both sortable.<\/li>\n
- Order lines sold at the happy hour price are tagged in classic and block checkout, and shown in the order details.<\/li>\n
- Refunds are deducted; cancelled and pending orders are excluded.<\/li>\n
- Estimated statistics for orders placed before the update.<\/li>\n<\/ul>\n\n
1.6.0<\/h4>\n\n\n- Campaigns: list, create, name, schedule, edit, duplicate, archive, restore and permanently delete.<\/li>\n
- Each campaign has its own schedule, discount, categories, on-sale behaviour, popup and banner.<\/li>\n
- Automatic start and end of every scheduled campaign; overlapping schedules are flagged.<\/li>\n
- Automatic migration of the 1.5 settings into a first campaign.<\/li>\n<\/ul>\n\n
Earlier versions<\/h4>\n\n
1.5.0 added the \"notify me\" button, the subscribers tab and the GDPR tools. 1.4.0 added the category pages. 1.3.0 added the cart countdown. 1.2.0 added the label below the product title. 1.1.0 added stacked discounts and mobile images. 1.0.0 was the first release.<\/p>","raw_excerpt":"Schedule WooCommerce happy hour campaigns: discount on selected categories, popup, banner\/slider shortcode, countdowns and sales statistics.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/371156","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=371156"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/contlimbu"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=371156"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=371156"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=371156"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=371156"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=371156"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=371156"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}