{"id":362101,"date":"2026-09-01T07:20:48","date_gmt":"2026-09-01T07:20:48","guid":{"rendered":"https:\/\/es.wordpress.org\/plugins\/glocalsaino-auctions-displayed-by-shortcodes\/"},"modified":"2026-09-02T09:38:57","modified_gmt":"2026-09-02T09:38:57","slug":"glocalsaino-auctions-displayed-by-shortcodes","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/glocalsaino-auctions-displayed-by-shortcodes\/","author":23548763,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.4.0","stable_tag":"1.4.0","tested":"7.1","requires":"6.0","requires_php":"7.2","requires_plugins":null,"header_name":"GlocalSaino Auctions Displayed by Shortcodes","header_author":"Glocal Saino","header_description":"Run direct and reverse auctions independently of any product page. Insert the [glocalsaino_auction] shortcode into any page or post to display the bid box.","assets_banners_color":"f6f6f6","last_updated":"2026-09-02 09:38:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/glocalsaino.com\/auctionsdisplayedbyshortcodes\/","header_author_uri":"https:\/\/glocalsaino.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":63,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.3.0":{"tag":"1.3.0","author":"glocalsaino","date":"2026-09-01 07:20:23","revision":3675519},"1.4.0":{"tag":"1.4.0","author":"glocalsaino","date":"2026-09-02 09:38:57","revision":3677636}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3675517,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3675517,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3675517,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3675517,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.3.0","1.4.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3675517,"resolution":"1","location":"assets","locale":"","width":1024,"height":593},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3675517,"resolution":"10","location":"assets","locale":"","width":1024,"height":405},"screenshot-11.png":{"filename":"screenshot-11.png","revision":3675517,"resolution":"11","location":"assets","locale":"","width":1024,"height":341},"screenshot-12.png":{"filename":"screenshot-12.png","revision":3675517,"resolution":"12","location":"assets","locale":"","width":1024,"height":678},"screenshot-13.png":{"filename":"screenshot-13.png","revision":3677635,"resolution":"13","location":"assets","locale":"","width":1024,"height":432},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3675517,"resolution":"2","location":"assets","locale":"","width":1024,"height":441},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3675517,"resolution":"3","location":"assets","locale":"","width":1024,"height":645},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3675517,"resolution":"4","location":"assets","locale":"","width":1024,"height":504},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3675517,"resolution":"5","location":"assets","locale":"","width":1024,"height":439},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3675517,"resolution":"6","location":"assets","locale":"","width":1024,"height":99},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3675517,"resolution":"7","location":"assets","locale":"","width":1024,"height":401},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3675517,"resolution":"8","location":"assets","locale":"","width":1024,"height":423},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3675517,"resolution":"9","location":"assets","locale":"","width":1024,"height":462}},"screenshots":{"1":"Page with an embedded auction shortcode: status badge, countdown, current bid, and bid form.","2":"Auction shortcode showing a \"Coming Soon\" state with the start countdown.","3":"Auction shortcode with the buy-it-now button alongside the standard bid form.","4":"Auction shortcode on an ended auction: closed status and final bid history.","5":"Auctions admin screen \u2014 auction metabox with the ready-to-copy shortcode.","6":"Auctions admin screen \u2014 start date and buy-it-now price fields.","7":"Settings page \u2014 General tab with currency and reminder timing.","8":"Settings page \u2014 Emails tab with HTML visual editor active.","9":"Bid list in the WordPress administration panel.","10":"Gallery shortcode showing several auctions as a card grid.","11":"Settings page \u2014 Appearance tab with the color pickers.","12":"Settings page \u2014 Appearance tab with the text strings table.","13":"Settings page \u2014 Payment tab: account holder name, IBAN, BIC\/SWIFT, bank name, and additional instructions for the bank transfer payment channel."}},"plugin_section":[],"plugin_tags":[],"plugin_category":[],"plugin_contributors":[275875,276054],"plugin_business_model":[],"class_list":["post-362101","plugin","type-plugin","status-publish","hentry","plugin_contributors-glocalsaino","plugin_contributors-rafammoo","plugin_committers-glocalsaino"],"banners":{"banner":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/banner-772x250.png?rev=3675517","banner_2x":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/banner-1544x500.png?rev=3675517","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/icon-128x128.png?rev=3675517","icon_2x":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/icon-256x256.png?rev=3675517","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-1.png?rev=3675517","caption":"Page with an embedded auction shortcode: status badge, countdown, current bid, and bid form."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-2.png?rev=3675517","caption":"Auction shortcode showing a \"Coming Soon\" state with the start countdown."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-3.png?rev=3675517","caption":"Auction shortcode with the buy-it-now button alongside the standard bid form."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-4.png?rev=3675517","caption":"Auction shortcode on an ended auction: closed status and final bid history."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-5.png?rev=3675517","caption":"Auctions admin screen \u2014 auction metabox with the ready-to-copy shortcode."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-6.png?rev=3675517","caption":"Auctions admin screen \u2014 start date and buy-it-now price fields."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-7.png?rev=3675517","caption":"Settings page \u2014 General tab with currency and reminder timing."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-8.png?rev=3675517","caption":"Settings page \u2014 Emails tab with HTML visual editor active."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-9.png?rev=3675517","caption":"Bid list in the WordPress administration panel."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-10.png?rev=3675517","caption":"Gallery shortcode showing several auctions as a card grid."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-11.png?rev=3675517","caption":"Settings page \u2014 Appearance tab with the color pickers."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-12.png?rev=3675517","caption":"Settings page \u2014 Appearance tab with the text strings table."},{"src":"https:\/\/ps.w.org\/glocalsaino-auctions-displayed-by-shortcodes\/assets\/screenshot-13.png?rev=3677635","caption":"Settings page \u2014 Payment tab: account holder name, IBAN, BIC\/SWIFT, bank name, and additional instructions for the bank transfer payment channel."}],"raw_content":"<!--section=description-->\n<p><strong>GlocalSaino Auctions Displayed by Shortcodes<\/strong> manages auctions through its own admin screen and a <code>[glocalsaino_auction]<\/code> shortcode that can be placed on any page or post \u2014 the description of the auctioned item does not need to live on a WooCommerce product page, or on any special page type at all. It supports two auction types: <strong>direct<\/strong> (the highest bid wins \u2014 for selling items) and <strong>reverse<\/strong> (the lowest offer wins \u2014 for sourcing services or quotes). Built on a clean MVC architecture, it delivers a full, entirely free auction experience for both administrators and visitors \u2014 no license key, no locked features, no usage caps.<\/p>\n\n<h3>Features<\/h3>\n\n<p><strong>Auction management from the backend<\/strong><\/p>\n\n<ul>\n<li>Dedicated <strong>Auctions<\/strong> admin screen (custom post type) with a metabox containing:\n\n<ul>\n<li><strong>Auction type<\/strong> \u2014 direct (highest bid wins) or reverse (lowest offer wins); locked once the first bid is placed.<\/li>\n<li><strong>Starting price<\/strong> \u2014 minimum amount for direct auctions, maximum starting amount for reverse ones.<\/li>\n<li><strong>Minimum step<\/strong> \u2014 smallest amount each bid must increase (direct) or decrease (reverse) compared to the previous one.<\/li>\n<li><strong>Closing date and time<\/strong> \u2014 the system automatically schedules closing events and notifications. Optionally leave it unset by checking <strong>No closing date<\/strong>, so the auction runs indefinitely until you manually give it a closing date.<\/li>\n<li><strong>Start date and time<\/strong> \u2014 optional; the auction displays as \"Coming Soon\" with a live countdown until it opens.<\/li>\n<li><strong>Instant-close price<\/strong> \u2014 an optional <strong>buy-it-now<\/strong> price for direct auctions, or a <strong>direct-award<\/strong> floor price for reverse ones. Direct auctions close immediately once a bid meets or exceeds this price; reverse auctions close immediately once an offer matches it exactly (no offer is accepted below it).<\/li>\n<li><strong>Public URL<\/strong> \u2014 the page where you place the shortcode, used as the link in emails and as the \"View Auction\" button target in the gallery shortcode.<\/li>\n<li><strong>Featured image<\/strong> \u2014 upload a photo for the auctioned item using WordPress's standard Featured Image box; shown in the gallery shortcode.<\/li>\n<\/ul><\/li>\n<li>Each auction shows its ready-to-use shortcode (<code>[glocalsaino_auction id=\"123\"]<\/code>) directly in the edit screen and in the admin list, along with its type.<\/li>\n<li><strong>Auction categories<\/strong>: an optional, hierarchical taxonomy for grouping auctions (e.g. \"Furniture\", \"Electronics\"), manageable from <strong>Auctions \u2192 Categories<\/strong>. Use it to filter the gallery shortcode to a single category.<\/li>\n<li>Bid list in the administration menu with columns for amount, user, auction, and date.<\/li>\n<\/ul>\n\n<p><strong>Shortcode \u2014 visitor experience<\/strong><\/p>\n\n<ul>\n<li>Place <code>[glocalsaino_auction id=\"123\"]<\/code> anywhere in the content of any page or post to display the auction box:\n\n<ul>\n<li>Status badge (Active \/ Ended \/ Coming Soon).<\/li>\n<li>Closing date and time in the format configured in WordPress settings.<\/li>\n<li>Real-time countdown timer (DD:HH:MM:SS) calculated server-side to avoid clock drift.<\/li>\n<li>Current bid and highest bidder; starting price if no bids have been placed.<\/li>\n<li>Minimum increment indicator.<\/li>\n<li>A matching instant-close button (\"Buy now for X\" \/ \"Direct award at X\") when an instant-close price is set.<\/li>\n<\/ul><\/li>\n<li>Bid form with server-side minimum amount validation. Bidders must be logged in.<\/li>\n<li>When time runs out, the form hides automatically and the badge switches to \"Ended\".<\/li>\n<li>After a successful bid, the current bid updates without reloading the page.<\/li>\n<li>History of the last 10 bids with bidder name, amount, and date\/time.<\/li>\n<\/ul>\n\n<p><strong>Gallery shortcode<\/strong><\/p>\n\n<ul>\n<li>Place <code>[glocalsaino_auctions]<\/code> on any page to display a responsive grid of all published auctions, each card showing:\n\n<ul>\n<li>The auction's featured image (or a neutral placeholder if none is set).<\/li>\n<li>Its status badge (Active \/ Ended \/ Coming Soon).<\/li>\n<li>A summary line \u2014 current bid or starting price, and the closing date (or \"No closing date\" for unlimited auctions).<\/li>\n<li>A \"View Auction\" button linking to the auction's Public URL (the button is omitted if that field is empty).<\/li>\n<\/ul><\/li>\n<li>Optional attributes:\n\n<ul>\n<li><code>category=\"slug\"<\/code> \u2014 show only auctions in one auction category (comma-separate multiple slugs to match any of them).<\/li>\n<li><code>limit=\"6\"<\/code> \u2014 cap the number of auctions shown (default: all).<\/li>\n<\/ul><\/li>\n<li>Example: <code>[glocalsaino_auctions category=\"furniture\" limit=\"8\"]<\/code>.<\/li>\n<\/ul>\n\n<p><strong>Bank transfer payment instructions<\/strong><\/p>\n\n<p>Configure your account holder name and IBAN under <strong>Auctions \u2192 Settings \u2192 Payment<\/strong>, and the \"auction ended\" email sent to the winner includes them automatically via the <code>{payment_instructions}<\/code> placeholder:<\/p>\n\n<ul>\n<li><strong>Direct auctions<\/strong> \u2014 the winner owes you, so they see your bank details and any additional instructions you add (e.g. a payment deadline or a reference to include).<\/li>\n<li><strong>Reverse auctions<\/strong> \u2014 it's the other way round, you owe the winning bidder \u2014 so instead of showing your own IBAN, the email asks them to reply with their account details so you can arrange the transfer.<\/li>\n<li>Leave the account holder name or IBAN empty to skip this entirely for direct auctions.<\/li>\n<li>Every piece of wording used to present these details \u2014 the intro line, the \"Account holder\"\/\"IBAN\"\/\"BIC\"\/\"Bank\" labels, and the reverse-auction request \u2014 can be reworded or translated under <strong>Auctions \u2192 Settings \u2192 Appearance \u2192 Text strings \u2192 Payment<\/strong>, the same as any other front-end text.<\/li>\n<\/ul>\n\n<p><strong>Customisable appearance<\/strong><\/p>\n\n<p>Everything under <strong>Auctions \u2192 Settings \u2192 Appearance<\/strong>, no CSS knowledge required:<\/p>\n\n<ul>\n<li><strong>Colors<\/strong> \u2014 pick the auction box background, text color, accent color (current bid amount, links), and the bid\/gallery button's background and text color, using WordPress's standard color picker.<\/li>\n<li><strong>Text strings<\/strong> \u2014 reword any text shown on the front end: status badges, date\/countdown labels, bid amount labels, the bid form, buttons and loading text, login\/closed messages, the bid history, and the gallery \u2014 grouped into a table with the current default shown as each field's placeholder. Leave a field empty to keep the default.<\/li>\n<\/ul>\n\n<p><strong>Automated email notifications<\/strong><\/p>\n\n<p>The plugin automatically sends the following emails:<\/p>\n\n<ol>\n<li><strong>Bid confirmed \u2192 bidder<\/strong>: confirms the bid was accepted, shows the amount, closing date, and a link to the auction's public page.<\/li>\n<li><strong>Outbid \u2192 previous highest bidder<\/strong>: notifies the user they have been outbid and includes a link to bid again.<\/li>\n<li><strong>New bid \u2192 admin<\/strong>: notifies the administrator of every received bid with the bidder's name and a link to the auction.<\/li>\n<li><strong>Reminder \u2192 all bidders and admin<\/strong>: sent automatically by WP-Cron before closing (lead time configurable); includes the current bid and closing date.<\/li>\n<li><strong>Auction ended \u2192 winner<\/strong>: congratulation email with the winning bid amount.<\/li>\n<li><strong>Auction ended \u2192 admin<\/strong>: summary with the winner's name, email, and winning bid amount. If no bids were placed, the admin is still notified.<\/li>\n<\/ol>\n\n<p>Every email's subject and body can be customised from the Settings page, in plain text or HTML (with a full WordPress visual editor), using placeholders for dynamic content:<\/p>\n\n\n\n\n  Placeholder\n  Description\n\n\n\n\n  <code>{site_name}<\/code>\n  Website name\n\n\n  <code>{product_name}<\/code>\n  Auctioned item's name\n\n\n  <code>{product_url}<\/code>\n  Auction's public URL\n\n\n  <code>{bid_amount}<\/code>\n  Bid amount\n\n\n  <code>{bidder_name}<\/code>\n  Bidder name\n\n\n  <code>{winner_name}<\/code>\n  Winner name\n\n\n  <code>{winner_email}<\/code>\n  Winner email address\n\n\n  <code>{end_date}<\/code>\n  Auction closing date and time\n\n\n  <code>{payment_instructions}<\/code>\n  Bank transfer details, or a request for the winner's own details on reverse auctions (see Payment settings)\n\n\n\n\n<p><strong>WP-Cron automation<\/strong><\/p>\n\n<ul>\n<li>When a closing date is saved on the auction, the plugin automatically schedules:\n\n<ul>\n<li>A reminder event before closing (lead time configurable, default 60 minutes).<\/li>\n<li>A closing event at the exact end time.<\/li>\n<\/ul><\/li>\n<li>If the closing date is updated, previous events are cancelled and rescheduled.<\/li>\n<\/ul>\n\n<p><strong>Security<\/strong><\/p>\n\n<ul>\n<li>Nonce verification on all AJAX requests and admin form submissions.<\/li>\n<li>Sanitisation and validation of all input data.<\/li>\n<li>Output escaped with <code>esc_html<\/code>, <code>wp_kses_post<\/code> and equivalent functions throughout all views.<\/li>\n<li>Minimum bid calculated and validated server-side, not only on the client.<\/li>\n<li>Prices in emails formatted with <code>html_entity_decode<\/code> to avoid visible HTML entities.<\/li>\n<\/ul>\n\n<p><strong>Internationalisation<\/strong><\/p>\n\n<ul>\n<li>Full i18n support; translations are loaded automatically by WordPress.<\/li>\n<li>Source strings are in English; the <code>.pot<\/code> translation template is included in the <code>languages\/<\/code> folder for translators and tools like Loco Translate.<\/li>\n<li>Text domain: <code>glocalsaino-auctions-displayed-by-shortcodes<\/code>.<\/li>\n<\/ul>\n\n<p><strong>Architecture<\/strong><\/p>\n\n<p>Clean MVC structure with clear separation of responsibilities:<\/p>\n\n<ul>\n<li><code>controllers\/<\/code> \u2014 CPT\/taxonomy registration, admin metabox, shortcode rendering, and AJAX bid handling.<\/li>\n<li><code>models\/<\/code> \u2014 business logic (bid validation, notifications).<\/li>\n<li><code>views\/<\/code> \u2014 PHP frontend templates rendered by the auction and gallery shortcodes.<\/li>\n<li><code>includes\/<\/code> \u2014 static helper class and settings class.<\/li>\n<li><code>assets\/<\/code> \u2014 CSS stylesheet and JavaScript.<\/li>\n<li><code>languages\/<\/code> \u2014 <code>.pot<\/code> translation template.<\/li>\n<\/ul>\n\n<p>This plugin makes no calls to any external service. Every feature \u2014 including plugin updates \u2014 runs entirely through WordPress core and your own site.<\/p>\n\n<h3>Usage<\/h3>\n\n<h3>Creating an auction<\/h3>\n\n<ol>\n<li>Go to <strong>Auctions \u2192 Add Auction<\/strong>.<\/li>\n<li>Choose the <strong>auction type<\/strong>: direct (highest bid wins) or reverse (lowest offer wins). This cannot be changed once the first bid is placed.<\/li>\n<li>Fill in the fields: starting price, minimum step, and closing date\/time.<\/li>\n<li>Optionally set a <strong>start date<\/strong>, an <strong>instant-close price<\/strong>, and the <strong>Public URL<\/strong> to the page where you'll place the shortcode (used in emails).<\/li>\n<li>Publish the auction and copy the shortcode it displays.<\/li>\n<li>Paste the shortcode into any page or post describing the item or service.<\/li>\n<\/ol>\n\n<h3>Reverse auctions<\/h3>\n\n<p>Choose <strong>reverse<\/strong> as the auction type to run a \"lowest offer wins\" auction \u2014 useful for sourcing services or quotes. The starting price acts as a ceiling (the first offer must be at or below it), each subsequent offer must be strictly lower than the current best (respecting the minimum step), and an optional direct-award floor price closes the auction the moment it's matched.<\/p>\n\n<h3>Scheduled start<\/h3>\n\n<p>In the auction's metabox, fill in the <strong>Start date and time<\/strong> field. Leave it empty if you want the auction to begin immediately upon publishing.<\/p>\n\n<h3>Instant close<\/h3>\n\n<p>In the auction's metabox, fill in the <strong>instant-close price<\/strong> field (labelled \"buy-it-now\" for direct auctions, \"direct award\" for reverse ones). Leave it empty to disable the feature.<\/p>\n\n<h3>Categories and images<\/h3>\n\n<p>Go to <strong>Auctions \u2192 Categories<\/strong> to create categories (e.g. \"Furniture\", \"Electronics\"), then assign one or more to each auction from the Categories box on its edit screen \u2014 just like WordPress's built-in post categories. Upload a photo for the auctioned item using the <strong>Featured Image<\/strong> box on the same edit screen; it's used by the gallery shortcode.<\/p>\n\n<h3>Gallery shortcode<\/h3>\n\n<p>Place <code>[glocalsaino_auctions]<\/code> on any page to list every published auction as a card grid \u2014 image, status, a bid\/price summary, and a button to the auction's page. Add <code>category=\"slug\"<\/code> to show only one category (or several, comma-separated), and <code>limit=\"6\"<\/code> to cap how many are shown.<\/p>\n\n<h3>Payment<\/h3>\n\n<p>Go to <strong>Auctions \u2192 Settings \u2192 Payment<\/strong> and enter your account holder name and IBAN (BIC\/SWIFT, bank name, and additional instructions are optional). This is only used for direct auctions, where the winner owes you \u2014 it's included automatically in the \"auction ended \u2192 winner\" email via the <code>{payment_instructions}<\/code> placeholder. For reverse auctions, that same email instead asks the winning bidder to reply with their own bank details, since you're the one who owes them.<\/p>\n\n<h3>Appearance<\/h3>\n\n<p>Go to <strong>Auctions \u2192 Settings \u2192 Appearance<\/strong> to restyle the plugin without editing any files:<\/p>\n\n<ul>\n<li>Use the <strong>color pickers<\/strong> to set the auction box background, text color, accent color, and button colors.<\/li>\n<li>Use the <strong>text strings<\/strong> table to reword anything shown on the front end \u2014 each field's placeholder shows the current default; leave it empty to keep that default.<\/li>\n<\/ul>\n\n<h3>General settings<\/h3>\n\n<p>Go to <strong>Auctions \u2192 Settings<\/strong> to:<\/p>\n\n<ul>\n<li>Set the currency symbol and its position.<\/li>\n<li>Set the reminder email lead time in minutes.<\/li>\n<li>Switch between plain text and HTML email format.<\/li>\n<li>Customise the subject and body of each email template.<\/li>\n<li>Add custom CSS (Appearance tab).<\/li>\n<\/ul>\n\n<h3>Viewing received bids<\/h3>\n\n<p>Go to <strong>Auctions \u2192 Auction Bids<\/strong> to see all registered bids with amount, user, auction, and date information.<\/p>\n\n<h3>Licence<\/h3>\n\n<p>This plugin is distributed under the GPLv2 or later licence.\nMore information: https:\/\/www.gnu.org\/licenses\/gpl-2.0.html<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> in your WordPress installation.<\/li>\n<li>Activate the plugin from the <strong>Plugins<\/strong> menu in the WordPress dashboard. No other plugin is required.<\/li>\n<li>Go to <strong>Auctions \u2192 Add Auction<\/strong>, choose the auction type (direct or reverse), set the starting price, minimum step, and closing date, then publish.<\/li>\n<li>Copy the shortcode shown on the edit screen (e.g. <code>[glocalsaino_auction id=\"123\"]<\/code>).<\/li>\n<li>Paste it into the page or post where you describe the auctioned item. The countdown timer and bid form will appear there automatically.<\/li>\n<li>Optionally, place <code>[glocalsaino_auctions]<\/code> on another page to show a gallery linking to all of your auctions.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20woocommerce%3F\"><h3>Do I need WooCommerce?<\/h3><\/dt>\n<dd><p>No. The plugin is fully independent and does not require WooCommerce or any other e-commerce plugin.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20email%20text%3F\"><h3>Can I change the email text?<\/h3><\/dt>\n<dd><p>Yes. Go to <strong>Auctions \u2192 Settings \u2192 Emails<\/strong> and edit the subject and body of each email type. Use the available placeholders to insert dynamic data.<\/p><\/dd>\n<dt id=\"can%20users%20bid%20without%20an%20account%3F\"><h3>Can users bid without an account?<\/h3><\/dt>\n<dd><p>Not currently \u2014 bidders must be logged in to place a bid.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20the%20auction%20ends%3F\"><h3>What happens when the auction ends?<\/h3><\/dt>\n<dd><p>WP-Cron executes the closing event automatically: it sends a congratulation email to the winner and a summary to the administrator. If no bids were placed, the administrator is notified anyway. The bid form disappears wherever the shortcode is displayed.<\/p><\/dd>\n<dt id=\"what%27s%20the%20difference%20between%20a%20direct%20and%20a%20reverse%20auction%3F\"><h3>What's the difference between a direct and a reverse auction?<\/h3><\/dt>\n<dd><p>In a direct auction the highest bid wins, like a classic auction for selling an item. In a reverse auction the lowest offer wins \u2014 useful when you want service providers or suppliers to compete on price for a job you need done.<\/p><\/dd>\n<dt id=\"what%20is%20the%20instant-close%20feature%3F\"><h3>What is the instant-close feature?<\/h3><\/dt>\n<dd><p>When an instant-close price is set, a direct auction closes the moment a bid meets or exceeds it (\"buy it now\"); a reverse auction closes the moment an offer matches it exactly (\"direct award\"), and no offer below it is accepted. Either way the auction closes on the spot, all closing emails are sent, and the countdown disappears.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20i%20update%20the%20closing%20date%20after%20saving%3F\"><h3>What happens if I update the closing date after saving?<\/h3><\/dt>\n<dd><p>The plugin automatically cancels the previous WP-Cron events and schedules new ones with the updated date.<\/p><\/dd>\n<dt id=\"can%20an%20auction%20run%20without%20a%20closing%20date%3F\"><h3>Can an auction run without a closing date?<\/h3><\/dt>\n<dd><p>Yes. Check <strong>No closing date<\/strong> in the auction's metabox and leave the closing date field empty \u2014 the auction stays active indefinitely (no automatic \"ended\" state, no reminder or closing emails) until you uncheck the box and set a real closing date.<\/p><\/dd>\n<dt id=\"is%20the%20countdown%20timer%20reliable%3F\"><h3>Is the countdown timer reliable?<\/h3><\/dt>\n<dd><p>The remaining time is calculated server-side when the page loads and the JavaScript counts down from that value. This avoids drift caused by differences between the server clock and the user's browser.<\/p><\/dd>\n<dt id=\"is%20it%20compatible%20with%20loco%20translate%3F\"><h3>Is it compatible with Loco Translate?<\/h3><\/dt>\n<dd><p>Yes. The plugin includes a <code>.pot<\/code> translation template in the <code>languages\/<\/code> folder. Open the plugin in Loco Translate, select or create a language, and save \u2014 Loco Translate will compile the <code>.mo<\/code> file automatically.<\/p><\/dd>\n<dt id=\"how%20do%20i%20show%20a%20gallery%20of%20all%20my%20auctions%3F\"><h3>How do I show a gallery of all my auctions?<\/h3><\/dt>\n<dd><p>Place <code>[glocalsaino_auctions]<\/code> on any page. Add <code>category=\"slug\"<\/code> to only show one auction category, or <code>limit=\"6\"<\/code> to cap how many are shown.<\/p><\/dd>\n<dt id=\"the%20gallery%27s%20%22view%20auction%22%20button%20doesn%27t%20appear%20on%20one%20of%20my%20auctions%20%E2%80%94%20why%3F\"><h3>The gallery's \"View Auction\" button doesn't appear on one of my auctions \u2014 why?<\/h3><\/dt>\n<dd><p>That button links to the auction's <strong>Public URL<\/strong> field. It's hidden when that field is empty, since there's nowhere for it to link to \u2014 fill it in on the auction's edit screen.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20process%20card%20payments%20%28stripe%2C%20paypal%2C%20etc.%29%3F\"><h3>Does the plugin process card payments (Stripe, PayPal, etc.)?<\/h3><\/dt>\n<dd><p>No. It supports bank transfer only: configure your IBAN under <strong>Auctions \u2192 Settings \u2192 Payment<\/strong> and it's included automatically in the winner's \"auction ended\" email for direct auctions. The plugin never touches card data or payment processing.<\/p><\/dd>\n<dt id=\"why%20does%20the%20winner%27s%20email%20ask%20for%20bank%20details%20instead%20of%20showing%20mine%2C%20for%20a%20reverse%20auction%3F\"><h3>Why does the winner's email ask for bank details instead of showing mine, for a reverse auction?<\/h3><\/dt>\n<dd><p>Because the money flows the other way in a reverse auction \u2014 the winning bidder is the one who gets paid, not the one who pays. The plugin doesn't have that bidder's bank details on file, so it asks them to reply with their account information instead of showing yours.<\/p><\/dd>\n<dt id=\"can%20i%20restyle%20the%20auction%20box%20or%20gallery%20to%20match%20my%20theme%3F\"><h3>Can I restyle the auction box or gallery to match my theme?<\/h3><\/dt>\n<dd><p>Yes, without editing any plugin files or writing CSS: go to <strong>Auctions \u2192 Settings \u2192 Appearance<\/strong> and use the color pickers to set the box background, text, accent, and button colors.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20wording%20shown%20on%20the%20front%20end%20%28button%20text%2C%20messages%2C%20etc.%29%3F\"><h3>Can I change the wording shown on the front end (button text, messages, etc.)?<\/h3><\/dt>\n<dd><p>Yes. <strong>Auctions \u2192 Settings \u2192 Appearance<\/strong> has a Text strings section listing every front-end string, grouped by where it appears. Each field shows the current default as its placeholder \u2014 type your own wording to override it, or leave it empty to keep the default.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Added extension points (actions\/filters on bid submission, the auction metabox, the bid form, gallery cards, and the settings page) so an optional add-on can offer guest bidding and security deposits without forking this plugin's code. No behavior changes with no add-on active.<\/li>\n<li>New \"Extensions\" screen (Auctions menu) listing available add-ons \u2014 a static page with no external calls, since this plugin doesn't bundle any third-party SDK.<\/li>\n<li>Settings \u2192 General now shows both shortcodes (single auction and gallery), with their optional attributes and an example \u2014 previously only documented in the readme.<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Removed the Freemius SDK entirely: the plugin no longer contacts any external service for any reason, including update checks \u2014 those are now handled solely by WordPress.org.<\/li>\n<li>Removed the free-form Custom CSS field from Appearance settings. Restyling is still available through the color pickers (auction box background, text, accent, and button colors).<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>New <strong>Payment<\/strong> settings tab: configure your account holder name and IBAN for bank transfer payment instructions, included automatically in the winner's \"auction ended\" email for direct auctions (via a new <code>{payment_instructions}<\/code> placeholder). For reverse auctions, that same email asks the winning bidder for their own bank details instead, since it's the site that owes them.<\/li>\n<li>All of that wording (not just the emails it's inserted into) can be reworded or translated under Appearance \u2192 Text strings \u2192 Payment.<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Fixed: the closing date\/time shown in emails ({end_date}), the auction box (\"Starts:\"\/\"Closes:\"), the admin auctions list, and the gallery cards could be off by your site's UTC offset (e.g. 1\u20132 hours) from the real closing time, due to a WordPress date-formatting function being used in a way that doesn't suit a real UTC timestamp. Bid history timestamps were not affected.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Appearance tab: added five color pickers (auction box background, text, accent, button background, button text) \u2014 no CSS knowledge needed to restyle the plugin.<\/li>\n<li>Appearance tab: every front-end text string is now editable (status badges, dates, bid form, buttons, messages, bid history, gallery) \u2014 leave a field empty to keep the built-in text.<\/li>\n<li>Custom CSS is still there for anything the color pickers don't cover.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Direct and reverse WordPress auctions via shortcode: real-time bidding, countdown timer, email notifications \u2014 no WooCommerce required.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/362101","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=362101"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/glocalsaino"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=362101"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=362101"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=362101"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=362101"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=362101"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=362101"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}