{"id":346064,"date":"2026-08-02T15:55:18","date_gmt":"2026-08-02T15:55:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/softula-widget\/"},"modified":"2026-08-02T15:54:44","modified_gmt":"2026-08-02T15:54:44","slug":"booking-widget-for-softula","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/booking-widget-for-softula\/","author":23539032,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0.2","requires":"5.0","requires_php":"","requires_plugins":null,"header_name":"Booking Widget for Softula","header_author":"Softula","header_description":"Embed the Softula booking widget on your WordPress site via the [softula] shortcode or block.","assets_banners_color":"fefefe","last_updated":"2026-08-02 15:54:44","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/softula.com","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":42,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"softulasoftware","date":"2026-08-02 15:54:44"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3631893,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3631893,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3631893,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3631893,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"softula\/widget":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"softula\/widget","title":"Booking Widget for Softula","category":"embed","description":"Embed the Softula booking widget (e.g. the Planner booking widget).","keywords":["softula","planner","booking","widget"],"textdomain":"booking-widget-for-softula","attributes":{"token":{"type":"string","default":""},"widget":{"type":"string","default":"planner"},"apiBase":{"type":"string","default":""},"version":{"type":"string","default":"latest"}},"supports":{"html":false},"editorScript":"file:.\/edit.js","render":"file:.\/render.php"}},"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3631893,"resolution":"1","location":"assets","locale":"","width":1586,"height":735}},"screenshots":{"1":"Settings page \u2014 configure the API base URL (staging\/self-hosted)."}},"plugin_section":[],"plugin_tags":[269,230,5883,162],"plugin_category":[40,43,56],"plugin_contributors":[274243],"plugin_business_model":[],"class_list":["post-346064","plugin","type-plugin","status-publish","hentry","plugin_tags-booking","plugin_tags-embed","plugin_tags-planner","plugin_tags-widget","plugin_category-calendar-and-events","plugin_category-customization","plugin_category-social-and-sharing","plugin_contributors-softulasoftware","plugin_committers-softulasoftware"],"banners":{"banner":"https:\/\/ps.w.org\/booking-widget-for-softula\/assets\/banner-772x250.png?rev=3631893","banner_2x":"https:\/\/ps.w.org\/booking-widget-for-softula\/assets\/banner-1544x500.png?rev=3631893","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/booking-widget-for-softula\/assets\/icon-128x128.png?rev=3631893","icon_2x":"https:\/\/ps.w.org\/booking-widget-for-softula\/assets\/icon-256x256.png?rev=3631893","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/booking-widget-for-softula\/assets\/screenshot-1.png?rev=3631893","caption":"Settings page \u2014 configure the API base URL (staging\/self-hosted)."}],"raw_content":"\n

Booking Widget for Softula embeds the Softula booking widget \u2014 such as the Planner booking widget \u2014 directly into your WordPress pages and posts via the [softula]<\/code> shortcode or the native \"Booking Widget for Softula\" block.<\/p>\n\n

The plugin only loads widget.js on pages where the shortcode or block is actually used.<\/p>\n\n

External services<\/h3>\n\n

This plugin connects to the Softula widget-delivery service to load and render the booking widget.<\/p>\n\n

It loads a JavaScript file (widget.js<\/code>) from https:\/\/planner-api.softula.com<\/code> (or a self-hosted\/staging API base configured via Settings) every time a page with the [softula]<\/code> shortcode or block is viewed. The request includes the widget version and, embedded in the rendered widget's markup, the site's configured embed token and widget type \u2014 no personal visitor data is sent by the plugin itself; any data exchanged once the widget is loaded (e.g. booking form submissions) is handled directly between the visitor's browser and Softula's API, governed by Softula's own terms.<\/p>\n\n

This service is provided by Softula: Terms of Service<\/a>, Privacy Policy<\/a>.<\/p>\n\n

Usage<\/h3>\n\n

Basic:<\/p>\n\n

[softula token=\"your-embed-token\" widget=\"planner\"]<\/p>\n\n

With API base override:<\/p>\n\n

[softula token=\"your-embed-token\" widget=\"planner\" api_base=\"https:\/\/test-planner-api.softula.com\"]<\/p>\n\n

Attributes:\n* token<\/code> (required) \u2014 your Softula embed token (found in the dashboard under widget settings).\n* widget<\/code> (required) \u2014 the widget type, e.g. \"planner\".\n* api_base<\/code> (optional) \u2014 override the API base URL. Default: https:\/\/planner-api.softula.com<\/code>, configurable via Settings \u2192 Booking Widget for Softula or SOFTULA_API_BASE<\/code> in wp-config.php.<\/p>\n\n\n

    \n
  1. Upload the booking-widget-for-softula<\/code> folder to \/wp-content\/plugins\/<\/code>.<\/li>\n
  2. Activate the plugin via the \"Plugins\" menu.<\/li>\n
  3. (Optional) Go to Settings \u2192 Booking Widget for Softula to configure a custom API base (staging\/self-hosted).<\/li>\n
  4. Add the [softula]<\/code> shortcode, or the \"Booking Widget for Softula\" block, to a page or post.<\/li>\n<\/ol>\n\n\n
    \n

    Does the plugin work with the block editor (Gutenberg)?<\/h3><\/dt>\n

    Yes. Besides the [softula]<\/code> shortcode, a native \"Booking Widget for Softula\" block is available in the block inserter (category \"Embeds\"). Fill in the token and widget type via the block settings in the sidebar.<\/p><\/dd>\n

    What happens to my settings when I remove the plugin?<\/h3><\/dt>\n

    When the plugin is deleted (not just deactivated), the stored API base setting is automatically removed from the database.<\/p><\/dd>\n

    Where do I find my embed token?<\/h3><\/dt>\n

    In the Softula dashboard, under the widget settings of the widget you want to embed.<\/p><\/dd>\n

    Can I use multiple widgets on one site?<\/h3><\/dt>\n

    Yes, use a separate shortcode or block per widget with its own token.<\/p><\/dd>\n\n<\/dl>\n\n\n

    1.0.0<\/h4>\n\n
      \n
    • Initial release<\/li>\n<\/ul>","raw_excerpt":"Embed the Softula booking widget on your WordPress site via a simple shortcode or block.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/346064","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=346064"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/softulasoftware"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=346064"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=346064"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=346064"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=346064"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=346064"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=346064"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}