{"id":152466,"date":"2022-01-28T14:50:02","date_gmt":"2022-01-28T14:50:02","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/driveworks-shortcode-form-embed\/"},"modified":"2025-04-24T08:49:32","modified_gmt":"2025-04-24T08:49:32","slug":"driveworks-shortcode-form-embed","status":"publish","type":"plugin","link":"https:\/\/mai.wordpress.org\/plugins\/driveworks-shortcode-form-embed\/","author":18843537,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.2","stable_tag":"1.0.2","tested":"6.8.5","requires":"4.0","requires_php":"5.6","requires_plugins":null,"header_name":"DriveWorks Shortcode - Form Embed","header_author":"DriveWorks Ltd","header_description":"Use shortcode to quickly embed DriveWorks Forms (Projects\/DriveApps)","assets_banners_color":"345162","last_updated":"2025-04-24 08:49:32","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/plugins.driveworkslive.com","header_author_uri":"https:\/\/driveworks.co.uk","rating":0,"author_block_rating":0,"active_installs":10,"downloads":1651,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"driveworks","date":"2022-01-28 14:49:53"},"1.0.1":{"tag":"1.0.1","author":"driveworks","date":"2025-04-23 11:08:30"},"1.0.2":{"tag":"1.0.2","author":"driveworks","date":"2025-04-24 08:49:32"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2668241,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2668241,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":2668241,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2671398,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2671398,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2671418,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2671398,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2668241,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"Enter the shortcode into text content.","2":"Enter connection details and other configuration options.","3":"Save and view the Form rendered in your content."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[207208,230,597,10301,80],"plugin_category":[56],"plugin_contributors":[207211],"plugin_business_model":[],"class_list":["post-152466","plugin","type-plugin","status-publish","hentry","plugin_tags-driveworks","plugin_tags-embed","plugin_tags-integration","plugin_tags-project","plugin_tags-shortcode","plugin_category-social-and-sharing","plugin_contributors-driveworks","plugin_committers-driveworks"],"banners":{"banner":"https:\/\/ps.w.org\/driveworks-shortcode-form-embed\/assets\/banner-772x250.png?rev=2671398","banner_2x":"https:\/\/ps.w.org\/driveworks-shortcode-form-embed\/assets\/banner-1544x500.png?rev=2671398","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/driveworks-shortcode-form-embed\/assets\/icon.svg?rev=2668241","icon":"https:\/\/ps.w.org\/driveworks-shortcode-form-embed\/assets\/icon.svg?rev=2668241","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/driveworks-shortcode-form-embed\/assets\/screenshot-1.png?rev=2671418","caption":"Enter the shortcode into text content."},{"src":"https:\/\/ps.w.org\/driveworks-shortcode-form-embed\/assets\/screenshot-2.png?rev=2671398","caption":"Enter connection details and other configuration options."},{"src":"https:\/\/ps.w.org\/driveworks-shortcode-form-embed\/assets\/screenshot-3.png?rev=2668241","caption":"Save and view the Form rendered in your content."}],"raw_content":"<!--section=description-->\n<p>This plugin enables the shortcode <strong>driveworks_embed<\/strong>, to quickly embed either a DriveWorks Project or DriveApp into any content.<\/p>\n\n<p>It uses pre-written <a href=\"https:\/\/webapi.driveworkslive.com\/help\/client\/\">DriveWorks Client SDK<\/a> functions to automatically create a client, login, start a Specification \/ DriveApp and render the Form.<\/p>\n\n<blockquote>\n  <p>Note: this plugin <em>requires<\/em> an external <a href=\"https:\/\/docs.driveworkspro.com\/Topic\/IntegrationThemeLive\">DriveWorks Live Integration Server<\/a> to be configured and running, which allows connections from your WordPress domain.<\/p>\n<\/blockquote>\n\n<p><strong>To embed a Form<\/strong>, simply provide the following:<\/p>\n\n<ul>\n<li><strong>server_url<\/strong> - The URL of your Integration Theme server. Used to load the client library, and create a client connection.<\/li>\n<li><strong>group_alias<\/strong> - The alias of the Group to connect to.<\/li>\n<li>Either: \n\n<ul>\n<li><strong>project_name<\/strong> - The name of the Project to render<\/li>\n<li><strong>drive_app_alias<\/strong> - The name of the DriveApp to render<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<p>Optionally provide:<\/p>\n\n<ul>\n<li><strong>ping_interval<\/strong> - The interval (in seconds) at which the server is automatically sent a request. Useful to keep a session alive without manual interaction. Disable by setting to <code>0<\/code>, or excluding this setting.<\/li>\n<li><strong>height<\/strong> - The height of the container that Form is rendered into, including the unit. Useful if the Form does not have a natural height. Examples: <code>800px<\/code>, <code>10em<\/code>, <code>75vh<\/code>.<\/li>\n<\/ul>\n\n<p><strong>Examples<\/strong><\/p>\n\n<p>Render a Project:<\/p>\n\n<pre><code>[driveworks_embed server_url=\"https:\/\/api.my-server.com\" group_alias=\"MyGroupAlias\" project_name=\"MyProject\"]\n<\/code><\/pre>\n\n<p>Render a DriveApp, with a fixed height, that pings every 60 seconds:<\/p>\n\n<pre><code>[driveworks_embed server_url=\"https:\/\/api.my-server.com\" group_alias=\"MyGroupAlias\" drive_app_alias=\"MyDriveApp\" height=\"700px\" ping_interval=\"60\"]\n<\/code><\/pre>\n\n<p><strong>How it works?<\/strong><\/p>\n\n<p>The shortcode is replaced with the markup required to embed and render a DriveWorks Form.<\/p>\n\n<p>A pre-written script using standard methods from the <a href=\"https:\/\/webapi.driveworkslive.com\/help\/client\/\">DriveWorks Live Client SDK<\/a>, running on your own server, performs a login and renders the configured Form.<\/p>\n\n<p>The script will not send any credentials during login, so <strong>a default user must be specified<\/strong> in <strong>DriveWorksConfigUser.xml<\/strong>.\nIf a default user is not set server-side, the connection will not be authorized.<\/p>\n\n<p>It is important to ensure that your DriveWorks Integration Theme server is running correctly.\nYou can check this by accessing the configured server_url in a browser.<\/p>\n\n<p>Clear warnings will be shown if any errors are made in the config or during connection.<\/p>\n\n<p>For alternative examples on how to render a DriveWorks Form, see our public <a href=\"https:\/\/webapi.driveworkslive.com\/home.html\">Client SDK Examples<\/a> and our <a href=\"https:\/\/github.com\/driveworks\">Official GitHub<\/a>.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id='is%20this%20plugin%20free%3F'><h3>Is this plugin free?<\/h3><\/dt>\n<dd><p>Yes - this plugin is free. However, it requires an existing DriveWorks Live Integration Theme server to be setup and running - which it will then connect to.\nFor more information and configuration guidance, see the official <a href=\"https:\/\/docs.driveworkspro.com\/Topic\/IntegrationThemeLive\">Integration Theme documentation<\/a><\/p><\/dd>\n<dt id='can%20i%20use%20multiple%20embeds%20on%20one%20page%3F'><h3>Can I use multiple embeds on one page?<\/h3><\/dt>\n<dd><p>Yes - however they will <strong>all share the same client library script<\/strong>.\nOnly <strong>1<\/strong> version of the library can be loaded on the same page.\nThe first server_url found in the content will be used to load the client library script.<\/p>\n\n<p>Multiple Integration Theme <em>servers<\/em> can be connected to and embedded at the same time, but please note that only the first instance of the library will be loaded.\nYou should ensure all Forms can run successfully on the shared version of DriveWorks.<\/p>\n\n<p>Embeds with the same server_url will re-use the same client for reduced overhead.<\/p><\/dd>\n<dt id='why%20won%27t%20my%20embed%20load%3F'><h3>Why won't my embed load?<\/h3><\/dt>\n<dd><p>There are various reasons an embed may not load correctly.<\/p>\n\n<p>Helpful error messages are shown for common issues - when logged into WordPress as an admin user.\nThe browser developer console (F12) will reveal more details regarding any errors encountered.<\/p>\n\n<p>To troubleshoot, ensure that:<\/p>\n\n<ul>\n<li>The configuration in your shortcode is correct.<\/li>\n<li>Your Integration Theme server is configured correctly in <strong>DriveWorksConfigUser.xml<\/strong><\/li>\n<li>Your Integration Theme server is running, and allows connections from this site.<\/li>\n<li>The Group Alias has a default username and password set in <strong>DriveWorksConfigUser.xml<\/strong><\/li>\n<\/ul>\n\n<p>For more setup instructions, see:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/docs.driveworkspro.com\/Topic\/IntegrationThemeSelect\">Selecting the Integration Theme<\/a><\/li>\n<li><a href=\"https:\/\/docs.driveworkspro.com\/Topic\/IntegrationThemeSettings\">Configuring the Integration Theme<\/a><\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Fixed: Undefined variable warnings with WP_DEBUG enabled.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fixed: Grammatical errors and markdown syntax<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release - with Project &amp; DriveApp support<\/li>\n<\/ul>","raw_excerpt":"Use shortcodes to embed DriveWorks Projects or DriveApps.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/152466","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=152466"}],"author":[{"embeddable":true,"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/driveworks"}],"wp:attachment":[{"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=152466"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=152466"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=152466"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=152466"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=152466"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/mai.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=152466"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}