Description

Maradigma connects WordPress with your Maradigma account so you can publish and manage your boat catalogue directly from your website.

The plugin is designed for boat charter websites that need synchronised 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.
Synchronise 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 synchronised 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 synchronised boat metadata with Yoast SEO when Yoast SEO is installed and active.

An active Maradigma account and valid API credentials are required to retrieve fleet data and use the connected booking features.

External service

This plugin connects to the Maradigma platform to retrieve boat data, media, availability, prices, additional services, payment-method information, and booking-related content.

The connection is initiated after a website administrator configures the plugin with valid Maradigma credentials. Additional requests are made when an administrator synchronises fleet content or when a visitor uses a connected catalogue, availability, pricing, or booking feature.

Depending on the feature being used, requests may include:

The website domain.
The Maradigma API public key.
Request signatures generated with the configured secret key.
Boat identifiers, language codes, dates, filters, and catalogue 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.

These data are used to return the requested catalogue information, calculate availability and prices, and create or process the requested booking in the connected Maradigma account.

The plugin may also display or download boat images, videos, and PDF files from URLs returned by Maradigma. Frontend JavaScript and CSS dependencies bundled with the plugin are loaded locally rather than from public CDNs.

Service provider: Maradigma / BCH MULTISERVICES S.L.

Service API endpoint: https://app.maradigma.com/api/external/v1

Provider website: https://maradigma.com/

Provider privacy policy: https://maradigma.com/en/privacy-policy

Website administrators should ensure that their own privacy policy explains the use of this external service and the booking data collected through their website where required.

Third-party libraries

This plugin bundles local copies of third-party front-end libraries instead of loading JavaScript or CSS from public CDNs in production.

See docs/THIRD-PARTY-NOTICES.md for library names, versions, licenses, and source URLs.

Source code and build

The complete human-readable source code and build tooling are publicly maintained at:

https://github.com/JonatanMachoMaza/maradigma-wordpress

JavaScript and CSS sources are located in assets/js and assets/css. Compiled production assets are written to assets/dist.

To reproduce the distributed assets from a clean checkout:

Run npm ci.
Run npm run build.

The repository includes package.json, package-lock.json, and the Vite configuration used for the build.

Installation

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 synchronisation options and synchronise your fleet.
Add the provided shortcodes to your pages, or build boat layouts using Gutenberg, Elementor, or WPBakery.

FAQ

Do I need a Maradigma account?

Yes. An active Maradigma account and valid API credentials are required for the connected catalogue, 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 synchronised 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 synchronised 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 Basket, Checkout, or My Account.

Does it support multilingual websites?

Yes. The plugin includes compatibility layers for WPML and Polylang and can synchronise 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 synchronise or generate boat metadata according to the configured SEO options.

Can synchronised boat URLs include their destination?

Yes. The boat base slug setting accepts the {{destination}} placeholder. For example, es:alquiler-barcos-{{destination}},en:boat-rental-{{destination}} generates localised paths such as /alquiler-barcos-mallorca/boat-slug/. The destination is synchronised from the connected Maradigma account. Re-synchronise existing boats after enabling this route format.

Does the plugin load front-end libraries from public CDNs?

No. The supported front-end libraries distributed with the plugin are bundled locally. Boat media returned by the connected Maradigma account may still be displayed from Maradigma-provided URLs.

Reviews

There are no reviews for this plugin.

Contributors and Developers

“Maradigma” is open source software. The following people have contributed to this plugin.

maradigma

“Maradigma” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Maradigma” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Change Log

0.1.182

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.

0.1.181

Reduced the rental-terms text and toggle typography to match the booking modal hierarchy.

0.1.180

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.

0.1.179

Added an explicit translated reload action when silent booking-token renewal and its retry both fail.

0.1.178

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.

0.1.177

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.

0.1.176

Improved the booking modal heading hierarchy and typography.

0.1.175

Added a theme-coloured directional indicator to the payment breakdown toggles.

0.1.174

Updated the booking modal overlay with a darker translucent background and an 8px backdrop blur.

0.1.173

Added the missing localised “Loading terms…” message to the booking modal.

0.1.172

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.

0.1.171

Fixed built-in boat-card labels so From, day, and Charter use the bundled gettext translations.
Corrected Spanish translations for boat details and cabins.
Added the missing minimum-passengers translation to every bundled language catalogue.

0.1.170

Replaced the single anonymous booking counter with fixed-window IP, browser-session, basket, 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.

0.1.169

Replaced the executable uploads log index with an inert HTML index and removed the legacy generated PHP file.
Added explicit nonce authorisation and anonymous rate limiting to public booking write endpoints.

0.1.168

Updated the bundled Select2 library to the stable 4.1.0 release.
Sanitised dynamic Gutenberg block output and legacy page-listing shortcode output with an explicit front-end HTML allowlist.
Restricted pricing diagnostics and cache bypasses to the server-side MARADIGMA_PLUGIN_DEBUG constant.
Removed direct writes to Elementor, GenerateBlocks, and Gutenverse-owned options.
Simplified the GeneratePress template nonce flow and retained capability checks.

0.1.167

Fixed excessive vertical space around archive filters on mobile layouts.
Included compiled runtime translation catalogues in release packages while keeping PO source files excluded.
Added localised date-range placeholder and clear-button labels.

0.1.166

Added destination-aware boat permalinks through the {{destination}} route placeholder.
Synchronised localised service destinations and exposed destination tokens to boat cards and SEO templates.
Added matching rewrite rules, safe fallback routes, and WooCommerce-compatible route sanitisation.
Added service_destination to the supported single-boat API expansions.

0.1.165

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.

0.1.164

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.

0.1.163

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.

0.1.162

Localised 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.

0.1.161

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 synchronisation.
Normalised the single-boat template source formatting.
Aligned the WordPress.org readme with the plugin’s current version and supported integrations.

0.1.44

Bundled front-end dependencies locally instead of loading Swiper, Flatpickr, noUiSlider, or jQuery UI theme CSS from public CDNs.
Added third-party library notices for bundled front-end dependencies.
Updated WordPress.org readme metadata and external service disclosure.
Documented current Gutenberg block support.

0.1.41

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.