{"id":387425,"date":"2026-10-15T15:34:22","date_gmt":"2026-10-15T15:34:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/fishbse-listings\/"},"modified":"2026-10-15T16:29:29","modified_gmt":"2026-10-15T16:29:29","slug":"fishbse-listings","status":"publish","type":"plugin","link":"https:\/\/kn.wordpress.org\/plugins\/fishbse-listings\/","author":23583225,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.5.1","stable_tag":"1.5.1","tested":"7.1.3","requires":"6.3","requires_php":"7.4","requires_plugins":null,"header_name":"FishBSE Listings","header_author":"FishBSE LLC","header_description":"Display your FishBSE listings and live auction bids in any WordPress theme with [fishbse_listings].","assets_banners_color":"","last_updated":"2026-10-15 16:29:29","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/fishbse.com\/","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":45,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.5.1":{"tag":"1.5.1","author":"fishbse","date":"2026-10-15 16:29:29","revision":3748943}},"upgrade_notice":{"1.5.1":"<p>The optional FishBSE footer credit is now disabled by default. Existing API keys and listing blocks remain supported. Enable the credit in settings if desired.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3748847,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3748847,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":{"fishbse\/listings":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"fishbse\/listings","version":"1.5.1","title":"FishBSE Listings","category":"widgets","icon":"store","description":"Display your FishBSE listings and auctions with automatic updates.","keywords":["fish","auction","marketplace"],"textdomain":"fishbse-listings","attributes":{"style":{"type":"string","default":""},"theme":{"type":"string","default":""},"cardWidth":{"type":"number","default":0}},"supports":{"html":false,"align":["wide","full"],"spacing":{"margin":true,"padding":true}},"editorScript":"fishbse-listings-editor","style":"fishbse-listings"}},"tagged_versions":["1.5.1"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[6542,286954,4528],"plugin_category":[],"plugin_contributors":[286955],"plugin_business_model":[],"class_list":["post-387425","plugin","type-plugin","status-publish","hentry","plugin_tags-auctions","plugin_tags-fishbse","plugin_tags-listings","plugin_contributors-fishbse","plugin_committers-fishbse"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/fishbse-listings\/assets\/icon-128x128.png?rev=3748847","icon_2x":"https:\/\/ps.w.org\/fishbse-listings\/assets\/icon-256x256.png?rev=3748847","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>FishBSE Listings connects your WordPress website to the FishBSE aquarium marketplace service. Display your own eligible public listings and auctions with the native FishBSE Listings block or [fishbse_listings] shortcode. Choose cards, list or compact layouts, theme colors, listing type, category and up to 24 items.<\/p>\n\n<p>Optional transaction buttons let buyers open FishBSE or use an on-page purchase\/bid panel. Embedded transactions use a FishBSE sign-in and approval popup followed by Stripe payment fields. FishBSE manages inventory, bid validation, auction timing, reservations, orders and payment status. This plugin does not import WooCommerce products or maintain a separate inventory database.<\/p>\n\n<p>An active FishBSE seller account, verified email and completed Stripe seller verification are required. Card payments and payouts must be enabled, and FishBSE must permit integration access for the account. The separate FishBSE Verified badge is not required. Public WordPress websites must use HTTPS. FishBSE service terms and applicable transaction fees apply; no plugin license key or paid plugin edition is required.<\/p>\n\n<p>The optional FishBSE footer logo and credit link are disabled by default. Listing links and transaction controls are part of the marketplace service. All distributed application source is included in readable form; no build step is required. See LICENSE.txt for licensing.<\/p>\n\n<p>Full instructions and limitations are included in USER-GUIDE.txt and in Settings &gt; FishBSE Listings &gt; How to use.<\/p>\n\n<h4>Watch FishBSE Listings in Action<\/h4>\n\n<p>See FishBSE Listings in action! Learn how to display\naquarium marketplace listings and auctions on your\nWordPress website.<\/p>\n\n<p>https:\/\/www.youtube.com\/watch?v=0wVJlaqtcrM<\/p>\n\n<h3>External service and privacy<\/h3>\n\n<p>This plugin requires FishBSE. It does not send FishBSE requests until a site administrator configures an API key. Saving a key initiates the connection; disconnecting removes that site's saved key.<\/p>\n\n<h4>FishBSE<\/h4>\n\n<p>FishBSE provides seller inventory, auction management, bid validation, reservations, order records and payment-status verification. Its service terms and privacy policy apply:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/fishbse.com\/terms.php\">FishBSE Terms of Service<\/a><\/li>\n<li><a href=\"https:\/\/fishbse.com\/privacy.php\">FishBSE Privacy Policy<\/a><\/li>\n<\/ul>\n\n<p>Every listing request reports this WordPress site's home URL in X-FishBSE-Site, including display-only installations. FishBSE stores the origin (scheme, host and port), seller ID, first\/last request times and request count so staff can review connected websites. These addresses are client-reported, not domain-ownership verification. Stripe seller verification and staff access controls are checked on every FishBSE request; the separate paid FishBSE Verified badge does not unlock this feature. Disabling access does not cancel existing orders or payments.<\/p>\n\n<p>Embedded transactions use a FishBSE sign-in\/approval popup and direct browser requests to https:\/\/fishbse.com\/wordpress_embed_api.php. These send the browser's origin, IP\/user agent, a short-lived buyer authorization, and the buyer's chosen bid or checkout options. Responses contain the scoped listing review, payment-session client secret and verified bid\/order result. Buyer access stays in browser memory; the plugin does not persist it in WordPress or localStorage. Stripe.js loads from https:\/\/js.stripe.com and sends payment details directly to Stripe. No FishBSE password or full card number is collected by WordPress. See USER-GUIDE.txt for setup, privacy details and limits.<\/p>\n\n<p>This plugin connects to https:\/\/fishbse.com\/wordpress_listings_api.php when validating a newly entered API key and when visitors load or refresh listings. Requests send the key in an Authorization header, the chosen listing filters, the WordPress home URL in X-FishBSE-Site on every request, and the WordPress server's IP address. Transaction-enabled feeds also send the home URL as return_url. Buyer sign-in uses https:\/\/fishbse.com\/wordpress_connect.php; redirect-mode transactions open https:\/\/fishbse.com\/wordpress_transaction.php. The key is saved in the WordPress options database and never included in public HTML or browser requests. FishBSE stores only a hash of the key. Protect your WordPress database and backups. Uninstalling deletes the current site's plugin settings; revoke the key in FishBSE to invalidate it everywhere.<\/p>\n\n<p>The service returns only the connected seller's public listing information, current auction bids, bid counts, open trade request counts, and auction dates. Visitors load listing images from their supplied image hosts and open FishBSE links to bid, enquire or purchase. No payment, bidder identity or private contact details are returned. FishBSE account registration is required.<\/p>\n\n<h4>Stripe<\/h4>\n\n<p>Stripe provides payment processing and card verification. Stripe.js loads from https:\/\/js.stripe.com\/v3\/ when the buyer opens a payment or card-verification step, not upon plugin activation. Card information and any requested billing\/shipping information are submitted through Stripe's fields directly to Stripe. Stripe also receives browser\/device and network information as described in its privacy policy. Authenticated FishBSE results may show a card brand and last four digits; these are not saved in WordPress settings or returned in the public inventory feed.<\/p>\n\n<ul>\n<li><a href=\"https:\/\/stripe.com\/legal\/ssa\">Stripe Services Agreement<\/a><\/li>\n<li><a href=\"https:\/\/stripe.com\/privacy\">Stripe Privacy Policy<\/a><\/li>\n<\/ul>\n\n<p>Listing images load from the HTTPS image hosts supplied in the FishBSE feed. These hosts receive normal image-request metadata, including the visitor's IP address. Plugin icons, styles and application scripts are bundled locally; Stripe.js is the documented payment-service exception.<\/p>\n\n<h3>Refresh behavior<\/h3>\n\n<p>Visible pages refresh every 15 seconds, rechecking access with FishBSE on each refresh. Hidden tabs pause refresh and update when reopened. The listings feed is read-only; embedded controls use separate buyer-authorized FishBSE requests and Stripe payment fields inside the WordPress page. Ended, canceled, completed, archived or unpublished listings are removed. Auction release\/finalization cron jobs on FishBSE must continue running normally.<\/p>\n\n<p>If FishBSE cannot be reached or a key is revoked, cards are cleared with an unavailable message instead of displaying stale prices. Replacing a key disconnects all sites using the previous key. Disconnecting in WordPress clears only that site's saved key. Revoke in the FishBSE dashboard to invalidate it everywhere.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Register at https:\/\/fishbse.com\/register.php and verify your email, then complete Stripe seller verification (card payments and payouts enabled).<\/li>\n<li>In your FishBSE dashboard, open WordPress listings and generate an API key.<\/li>\n<li>Upload fishbse-listings.zip through Plugins &gt; Add New &gt; Upload Plugin and activate.<\/li>\n<li>Open Settings &gt; FishBSE Listings. Review the service\/privacy information, paste your key and save to connect.<\/li>\n<li>Choose cards, list or compact; theme colors; a listing type; a category; and a maximum of 1\u201324 items.<\/li>\n<li>In the WordPress block editor, click +, search FishBSE Listings, and insert or drag the block into your page or template. The editor previews your connected listings. Use the sidebar to override layout and colors for each block; type, category and quantity follow the site settings. Wide\/full alignment and spacing controls are available where supported by your theme.\nExisting [fishbse_listings] Shortcode blocks continue working.\nPHP templates can use: echo do_shortcode('[fishbse_listings]');<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20buyers%20purchase%20or%20bid%20from%20my%20website%3F\"><h3>Can buyers purchase or bid from my website?<\/h3><\/dt>\n<dd><p>Yes. Enable transaction buttons and choose Stay on this website. Buyers sign in and approve access in a FishBSE popup, then review\/submit bids and complete Stripe card checkout in an on-page panel. FishBSE remains authoritative for prices, inventory, consent, bids and order\/payment status. Buyer access expires after 30 minutes and is specific to the item and website. Requires HTTPS, popups, and enabled FishBSE service access. Redirect mode remains optional. Order management, refunds and later auction winner-payment recovery remain on FishBSE. Closing the panel does not cancel an accepted bid or payment.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20with%20my%20theme%3F\"><h3>Can I use this with my theme?<\/h3><\/dt>\n<dd><p>Yes. Use the native FishBSE Listings block, a Shortcode block or the PHP shortcode helper. The theme must call wp_head() and wp_footer(). Listing filters are shared across the site; each native block can override its layout and colors. Native block insertion requires the WordPress block editor (Gutenberg); other page builders can use the shortcode. Configure multisite installations individually; network-wide management is not provided.<\/p><\/dd>\n<dt id=\"how%20many%20websites%20can%20use%20a%20key%3F\"><h3>How many websites can use a key?<\/h3><\/dt>\n<dd><p>The key can be used on multiple sites. FishBSE allows 120 authenticated requests per minute per account, shared across all sites. Successful responses are not cached by this plugin. Traffic from many visitors or sites may reach this shared allowance; rate-limited feeds fail closed.<\/p><\/dd>\n<dt id=\"does%20this%20create%20wordpress%20products%3F\"><h3>Does this create WordPress products?<\/h3><\/dt>\n<dd><p>It displays a live feed. It does not import posts or WooCommerce products.<\/p><\/dd>\n<dt id=\"is%20the%20fishbse%20footer%20link%20required%3F\"><h3>Is the FishBSE footer link required?<\/h3><\/dt>\n<dd><p>No. The footer logo and credit link are optional and disabled by default. Enable them in the display settings only if desired.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.5.1<\/h4>\n\n<ul>\n<li>Make the public footer credit optional and disabled by default.<\/li>\n<li>Clarify external-service data sharing, account requirements and privacy links.<\/li>\n<li>Use bundled icons without remote icon fallbacks.<\/li>\n<li>Prepare directory submission documentation and licensing.<\/li>\n<\/ul>\n\n<h4>1.5.0<\/h4>\n\n<ul>\n<li>Authenticated auction panels display the seller-specific saved card brand and last four digits.<\/li>\n<li>Verified purchase results display the card used when Stripe details are available.<\/li>\n<li>Card entry and selection remain inside Stripe; no full card number or CVC is exposed to WordPress.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<p>Embedded purchase\/bid panels with FishBSE popup authorization, origin\/item\/buyer-bound short-lived access, Stripe card checkout and bidder verification, explicit consent, verified results and reservation cancellation. Hosted mode remains available. Requires a separate additive website migration and deployment.<\/p>\n\n<h4>1.3.0<\/h4>\n\n<p>Buy now and Place bid buttons with signed, expiring navigation to FishBSE's existing authenticated transaction flows. Optional display-only mode, disabled editor button previews, and seller-site return links in the separate FishBSE website update. Existing API keys and database schema remain compatible.<\/p>\n\n<h4>1.2.1<\/h4>\n\n<p>Optional per-block listing width, 240\u20131000px, with a live editor slider and responsive sizing.<\/p>\n\n<h4>1.2.0<\/h4>\n\n<p>FishBSE app icon, redesigned admin panel with live display preview and detailed usage guide. The separate FishBSE dashboard update prevents key regeneration on refresh and duplicate POST replay.<\/p>\n\n<h4>1.1.0<\/h4>\n\n<p>Native FishBSE Listings block with editor preview, per-block layout\/color controls, wide\/full alignment and spacing. Existing shortcodes and account connections remain compatible. Requires WordPress 6.3 or newer.<\/p>\n\n<h4>1.0.3<\/h4>\n\n<p>Distinguish Cloudflare browser challenges and HTTP access blocks from API-key rejection. Remove duplicate settings notices.<\/p>\n\n<h4>1.0.2<\/h4>\n\n<p>Added Settings and Get API key links in Installed Plugins.<\/p>\n\n<h4>1.0.1<\/h4>\n\n<p>API key management moved to Dashboard &gt; WordPress listings. Existing keys continue working.<\/p>\n\n<h4>1.0.0<\/h4>\n\n<p>Initial seller API integration, profile key management, display settings and automatic refresh.<\/p>","raw_excerpt":"Display your FishBSE listings and auction bids in your WordPress theme.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/387425","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=387425"}],"author":[{"embeddable":true,"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/fishbse"}],"wp:attachment":[{"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=387425"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=387425"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=387425"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=387425"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=387425"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/kn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=387425"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}