Maradigma
| 开发者 | maradigma |
|---|---|
| 更新时间 | 2026年9月25日 18:26 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Maradigma connects WordPress with your Maradigma account so you can publish and manage your boat catalog directly from your website.
The plugin is designed for boat charter websites that need synchronized fleet data, editable boat pages, searchable listings, availability and pricing information, and an integrated booking flow.
Main capabilities:
- Connect WordPress to Maradigma using the API credentials provided with your account.
- Synchronize boats, boat data, media, and supported multilingual content.
- Create and update boat pages through a dedicated custom post type.
- Display responsive boat listings with filters, sorting, pagination, and editable boat cards.
- Render individual boat content through shortcodes, PHP templates, Gutenberg blocks, Elementor widgets, or WPBakery elements.
- Display galleries, videos, specifications, descriptions, equipment, included and excluded items, additional services, prices, PDF files, and availability calendars.
- Let visitors select dates, configure a booking, provide their contact details, choose an available payment method, and submit the booking to Maradigma.
- Build and propagate editable master layouts for synchronized boat pages.
- Link WooCommerce products to Maradigma boats when WooCommerce is installed and active.
- Provide compatibility layers for GeneratePress, GenerateBlocks, and Gutenverse where those products are active.
- Support multilingual sites using WPML or Polylang.
- Integrate synchronized boat metadata with Yoast SEO when Yoast SEO is installed and active.
- The website domain.
- The Maradigma API public key.
- Request signatures generated with the configured secret key.
- Boat identifiers, language codes, dates, filters, and catalog query parameters.
- Booking selections and contact details entered by the visitor, such as name, email address, telephone number, country, and other fields displayed in the booking form.
安装:
- Upload the plugin folder to
/wp-content/plugins/, or install the plugin through the WordPress administration area. - Activate Maradigma.
- Go to Maradigma > Settings.
- Enter the API connection details supplied with your Maradigma account.
- Save the settings and verify the connection.
- Configure the boat-page synchronization options and synchronize your fleet.
- Add the provided shortcodes to your pages, or build boat layouts using Gutenberg, Elementor, or WPBakery.
屏幕截图:
常见问题:
Do I need a Maradigma account?
Yes. An active Maradigma account and valid API credentials are required for the connected catalog, availability, pricing, and booking features.
Does the plugin create boat pages in WordPress?
Yes. The plugin registers a dedicated boat post type and can create or update synchronized boat pages. Administrators can choose how generated layouts and boat data are updated.
Can I display a boat listing on any page?
Yes. Add the fleet listing shortcode to a page, post, or compatible builder element:
[maradigma_boats]
The shortcode supports filters, sorting, pagination, configurable filter placement, and editable boat-card templates. A complete shortcode reference is included in docs/MARADIGMA_SHORTCODES.md.
Can I display a single boat inside a page template or builder layout?
Yes. The plugin provides a full single-boat shortcode and field-specific shortcodes.
Examples:
[maradigma_boat slug="my-boat-slug"]
[maradigma_boat_title]
[maradigma_boat_booking]
Which page builders are supported?
The plugin provides native Gutenberg blocks, dedicated Elementor widgets, and WPBakery elements for fleet listings and individual boat content. It also provides editable master layouts that can be propagated to synchronized boat pages.
Does the plugin integrate with WooCommerce?
Yes, when WooCommerce is installed and active. Public WooCommerce products can be linked to Maradigma boats and used as boat-detail pages. The integration does not replace WooCommerce checkout and does not modify WooCommerce system pages such as Cart, Checkout, or My Account.
Does it support multilingual websites?
Yes. The plugin includes compatibility layers for WPML and Polylang and can synchronize language-specific boat pages and metadata according to the active multilingual configuration.
Does it work with Yoast SEO?
When Yoast SEO is installed and active, the plugin can synchronize or generate boat metadata according to the configured SEO options.
Can synchronized boat URLs include their destination and boat type?
Yes. The boat base slug setting accepts the {{destination}} and {{boat_type}} placeholders. For example, es:{{destination}}/alquiler-{{boat_type}},en:{{destination}}/boat-rental-{{boat_type}} generates localized paths such as /mallorca/alquiler-yate/boat-slug/ and /ibiza/alquiler-lancha/boat-slug/. The values are synchronized from the connected Maradigma account. Re-synchronize existing boats after enabling this route format.
Does the plugin load frontend libraries from public CDNs?
No. The supported frontend libraries distributed with the plugin are bundled locally. Boat media returned by the connected Maradigma account may still be displayed from Maradigma-provided URLs.
更新日志:
0.1.193
- Added Destination and Base port filters to boat listings. List
destinationorboat_base_portinfilters_ui_fields(or in the "More filters" drawer) and visitors get a searchable selector. Both lists are built from your own boats — with the number of boats in each place — so they only offer places that return results. - Rewrote the filters section of the shortcode documentation. It now has a visible table of every filter field a visitor can use, with the control they see and the
md_*parameter it sends, the real default values, the search attributes of the listing (including base port and skipper), and examples that use length, cabins, skipper and online booking. The fields were already there; the documentation buried them. - Fixed the navigation of the HTML documentation: a leftover tag in its header sent every index link and every "Back to top" link to a blank page, so the manual could not be browsed.
- Fixed the price slider when a filtered address is shared or reloaded (
allow_url_filters="1"): the slider took the visitor's own values as its ends, so the range could not be widened again except with "Reset".
- Stopped the public boat address (
/wp-json/maradigma/v1/boats/{id}) from answering visitors with internal data. On request it returned the boat owner's record (e-mail, tax id), the accounting data and, on every call, the commission and the private calendar (iCal) address of the boat. It now returns only the customer-facing fields the booking modal needs. The shop cart address also returns only the fields the booking flow reads, and is no longer cached by intermediaries. - Made "Specific boats" work in boat listings (shortcode, Elementor widget, Gutenberg block and WPBakery). The Maradigma search cannot filter by a list of boat IDs, so the plugin now applies the selection itself: the other filters (boat type, destination, dates…) still apply, and with the default order the boats keep the order of your list.
- Removed the unused
/wp-json/maradigma/v1/bookingaddress, which forwarded the "booking without payment" call of the API. - Stopped sending a payment method the API does not know ("card") when online booking starts before the payment step is shown, which made the API reject the request. The plugin now lets the API apply the online payment method configured in Maradigma, and no longer forwards a customer ID coming from the browser.
- Requested the rental conditions in the language of the page: the language never reached the API, so they always came back in the site's default language.
- Made the obsolete-page cleanup safer: a boat that is only unpublished in Maradigma now has its page unpublished (never trashed or deleted) and published again when the boat returns; the cleanup is skipped when the API connection changed since the last sync, or when most of the site's boats are missing from the API list (usually another API key).
- Kept the filters set by the page author (such as the full-catalogue option) when visitors paginate or change a filter; the AJAX refresh dropped them.
- Listed the same catalogue in the visitor's "Specific boat" selector as in the listing, which showed only boats bookable online.
- Removed the tags selector from the filters bar: the API publishes no tag catalogue, so it was always empty. The
tags="3,7"attribute still filters by tag ID. - Refreshed the availability of the booking calendar every 2 minutes instead of every hour, and stopped the Elementor boat widgets from calling the API again on every render.
- Fixed the base ports search in the admin, which pointed at a missing function.
- Ignored the legacy
port="<place name>"attribute of[maradigma_boats]instead of searching the name as text, which returned nothing: usedestination="1704"(orport="port:12") to limit a listing to a place. - Removed the "Featured first" option from the listing order selectors: the Maradigma search sorts that option with the featured boats at the end. The first option is now "Fleet order", the order you set in Maradigma, and a page that still carries the old value falls back to it. For a featured section use
featured="1", and to show featured boats first move them to the top of your fleet order in Maradigma. - Corrected the shortcode documentation: the licence filter is inverted (
boat_licence_required="0"are the boats that require a licence), the text search only looks at model, trade name, builder and reference (not places), and the attributes the API ignores are now marked as such.
- Added a Destination filter to boat listings: the Elementor Boats Archive widget and the Gutenberg block list the destinations of your boats (islands, localities, regions…) with how many boats each has, and the
destinationshortcode attribute limits a listing to them. Combined with the boat type, it gives one page per boat type in each destination, and it stays applied when visitors filter or paginate. - Fixed the Boat type, Builders and Specific boats selectors of the Elementor Boats Archive widget, which stayed empty when the "Listing defaults" section was opened, and showed saved values by name instead of their ID. Opening the section no longer marks the page as modified.
- Redirected an old boat address to the boat's page in the language of the address. When the old slug had become the current slug of another language's page, visitors were sent to that other language.
- Counted each boat once in the sync progress. The obsolete-page cleanup now skips runs that saw fewer boats than the API reported, and only removes the pages of boats that Maradigma confirms no longer exist or are unpublished.
- Preselected "Move duplicates to trash" in the boat sync form, so the next sync retires the duplicate boat pages left by earlier versions. Retired copies can be restored from the trash, and their addresses redirect to the kept page. "Only report them" is still available.
- Kept duplicate boat pages whose layout was edited by hand, even without the custom-layout option: the sync only retires copies whose layout is still the one it created.
- Stopped the boat sync from creating a second page for the same boat and language when it runs from the admin screen on Polylang sites. Polylang filtered the sync's page lookup by the admin's language, so pages in the other languages were not found and were created again.
- Detected duplicate boat pages (same boat and language) during the sync and listed them in the sync panel. A new sync option moves them to the trash or unpublishes them, and their addresses redirect to the page that is kept. Pages with a custom layout or marked as no-sync are kept and never retired.
- Linked boat listings, boat cards, and related boats to the same page the sync keeps (a customized page first, then the one in the translation group), and never to drafts or private pages.
- Kept boat page slugs stable between syncs. A slug now changes only when the boat's name changes in Maradigma.
- Redirected old boat addresses to the published page in the same language when several pages once used that address.
- Kept regional languages such as pt-BR and pt-PT apart when matching boat pages.
- Added the WPBakery layout to new boat pages in "overwrite" mode, and treated an empty Elementor layout as missing so the sync adds it.
- Counted and cleaned up boat pages in every language, whatever language filter is selected in the admin.
- Moved boats to the trash with "Delete all boats" unless "Delete permanently" is checked; they were always deleted permanently.
- Translated two booking error messages that the translation compiler had been dropping.
- Rendered the "No boats found" message, the boat cards, and the pagination returned by listing refreshes in the language of the page instead of the site language.
- Used the translations bundled with the plugin when WordPress does not have the language pack of the page installed.
- Rendered boat cards in Dutch on Dutch pages.
- Added cabins, bathrooms, boat length, and skipper options to the boat listing filters, and turned the minimum-passengers field of the "More filters" drawer into a - / + selector.
- Kept the attributes fixed in a boat listing shortcode, such as the boat type, applied after filter and pagination refreshes by carrying them in a signed listing scope.
- Kept internal listing settings out of the browser address bar, pagination links, and the reset link.
- Translated the "Price per day" label and the VAT texts of the boat prices shortcode, and renamed the builder filter to "Brand".
- Fixed the Clear button of the price dropdown so it resets the slider.
- Confirmed compatibility with WordPress 7.1.
- Restored full boat photo galleries on the boat detail view by falling back to the synchronized image service when the cached boat record only included a single photo.
- Loaded the gallery lightbox assets whenever the lightbox option is enabled, not only for the slider layout, fixing photos that opened as plain links instead of the lightbox.
- Added the bathrooms field to the boat specifications catalog, including its label and icon.
- Prevented dynamic boat rewrite rules from intercepting static destination and boat-type pages.
- Required complete dynamic boat paths and retained the unambiguous
/boats/fallback when routing data is incomplete. - Regenerated persisted WordPress rewrite rules automatically after plugin updates and route-setting changes.
- Added destination- and boat-type-aware URL templates with
{{destination}}and{{boat_type}}placeholders. - Preferred commercial island destinations such as Ibiza and Mallorca over localities and ports in boat URLs.
- Redirected stale dynamic boat routes to the current localized permalink and aligned Yoast canonical URLs.
- Preserved synchronized JSON payloads correctly when storing them as WordPress post metadata.
- Replaced the half-day dropdown with visible, accessible schedule cards.
- Kept unavailable schedules visible, marked them as occupied, and prevented their selection.
- Improved spacing between the schedule heading, help text, and available choices.
- Reduced the rental-terms text and toggle typography to match the booking modal hierarchy.
- Refreshed booking availability without browser cache whenever the modal opens.
- Removed occupied half-day schedules from the selector and disabled full-day rental when any required schedule is unavailable.
- Revalidated selected schedules against the live price response and refreshed the options when availability changes.
- Added an explicit translated reload action when silent booking-token renewal and its retry both fail.
- Prevented browser AbortSignal implementation messages from being exposed to customers.
- Added a dedicated 45-second timeout for booking and payment operations while retaining the standard timeout for regular API reads.
- Prevented the rental-terms toggle from resetting the modal scroll position on small screens.
- Replaced the terms anchor with an accessible button and retained loaded terms while toggling.
- Improved the booking modal heading hierarchy and typography.
- Added a theme-colored directional indicator to the payment breakdown toggles.
- Updated the booking modal overlay with a darker translucent background and an 8px backdrop blur.
- Added the missing localized “Loading terms…” message to the booking modal.
- Added a non-cacheable booking security-token refresh endpoint.
- Automatically refreshes an invalid booking nonce and retries the protected request once.
- Preserves the original idempotency key during the retry to prevent duplicate bookings or payments.
- Fixed built-in boat-card labels so
From,day, andCharteruse the bundled gettext translations. - Corrected Spanish translations for boat details and cabins.
- Added the missing minimum-passengers translation to every bundled language catalog.
- Replaced the single anonymous booking counter with fixed-window IP, browser-session, cart, and payment policies.
- Added standards-compatible HTTP 429 retry metadata and filterable policy limits.
- Added idempotency protection to payment-producing booking requests to prevent duplicates after retries or timeouts.
- Replaced the executable uploads log index with an inert HTML index and removed the legacy generated PHP file.
- Added explicit nonce authorization and anonymous rate limiting to public booking write endpoints.
- Updated the bundled Select2 library to the stable 4.1.0 release.
- Sanitized dynamic Gutenberg block output and legacy page-listing shortcode output with an explicit frontend HTML allowlist.
- Restricted pricing diagnostics and cache bypasses to the server-side
MARADIGMA_PLUGIN_DEBUGconstant. - Removed direct writes to Elementor, GenerateBlocks, and Gutenverse-owned options.
- Simplified the GeneratePress template nonce flow and retained capability checks.
- Fixed excessive vertical space around archive filters on mobile layouts.
- Included compiled runtime translation catalogs in release packages while keeping PO source files excluded.
- Added localized date-range placeholder and clear-button labels.
- Added destination-aware boat permalinks through the
{{destination}}route placeholder. - Synchronized localized service destinations and exposed destination tokens to boat cards and SEO templates.
- Added matching rewrite rules, safe fallback routes, and WooCommerce-compatible route sanitization.
- Added
service_destinationto the supported single-boat API expansions.
- Added complete GPL, MIT, Apache-2.0, and ODbL license texts to release packages.
- Documented Tom Select, its OrchidJS dependencies, and the bundled geographic dataset.
- Fixed damaged UTF-8 text in the boat-card and Elementor administration scripts.
- Restricted payment return URLs to destinations approved by WordPress.
- Replaced HEREDOC/NOWDOC syntax and excluded unused legacy Select2 translations from releases.
- Clarified repository security reporting and licensing.
- Hardened boat-card template storage and shortcode output escaping.
- Replaced inline admin assets with WordPress-enqueued files.
- Updated Select2 to the stable 4.0.13 release.
- Removed dynamic gettext calls and improved failed-nonce responses.
- Documented the public source repository and reproducible asset build.
- Excluded repository translation binaries from WordPress.org release packages.
- Updated the Plugin URI to point to the dedicated Maradigma WordPress plugin page.
- Kept the Author URI separate so WordPress.org can distinguish plugin information from author information.
- Localized the plugin description for Catalan, German, British English, Spanish, French, Italian, and Dutch WordPress installations.
- Aligned the plugin header and WordPress.org short description across all supported languages.
- Improved WordPress.org discovery tags to focus on boat rental, yacht charter, booking, availability, and fleet management.
- Expanded and clarified the public documentation for integrations, external services, privacy, and supported workflows.
- Added native Elementor Style controls for boat equipment, description, gallery, included items, and additional services widgets.
- Preserved existing gallery spacing and radius defaults while exposing them through Elementor controls.
- Added a stable description wrapper for scoped typography, spacing, background, and border controls.
- Improved WordPress.org Plugin Check compatibility for multilingual boat synchronization.
- Normalized the single-boat template source formatting.
- Aligned the WordPress.org readme with the plugin's current version and supported integrations.
- Bundled frontend dependencies locally instead of loading Swiper, Flatpickr, noUiSlider, or jQuery UI theme CSS from public CDNs.
- Added third-party library notices for bundled frontend dependencies.
- Updated WordPress.org readme metadata and external service disclosure.
- Documented current Gutenberg block support.
- Updated plugin metadata for WordPress.org readiness.
- Added a WordPress.org-compatible license declaration.
- Aligned the stable tag with the plugin version.
- Improved readme documentation for the current feature set.