Changeset 2668381
- Timestamp:
- 01/28/2022 04:17:40 PM (4 years ago)
- File:
-
- 1 edited
-
driveworks-shortcode-form-embed/trunk/readme.txt (modified) (7 diffs)
Legend:
- Unmodified
- Added
- Removed
-
driveworks-shortcode-form-embed/trunk/readme.txt
r2668241 r2668381 2 2 Contributors: driveworks 3 3 Tags: driveworks, driveworks live, embed, driveapp, project, shortcode, integration theme, integration 4 Stable tag: 1.0. 04 Stable tag: 1.0.1 5 5 Requires at least: 4.0 6 6 Tested up to: 5.8 … … 19 19 > Note: this plugin *requires* an external [DriveWorks Live Integration Server](https://docs.driveworkspro.com/Topic/IntegrationThemeLive) to be configured and running, which allows connections from your WordPress domain. 20 20 21 To embed a Form, simply provide the following: 22 * `server_url` - The URL of your Integration Theme server. Used to load the client library, and create a client connection. 23 * `group_alias` - The alias of the Group to connect to. 21 **To embed a Form**, simply provide the following: 22 23 * **server_url** - The URL of your Integration Theme server. Used to load the client library, and create a client connection. 24 * **group_alias** - The alias of the Group to connect to. 24 25 * Either: 25 * `project_name`- The name of the Project to render26 * `drive_app_alias`- The name of the DriveApp to render26 * **project_name** - The name of the Project to render 27 * **drive_app_alias** - The name of the DriveApp to render 27 28 28 29 Optionally provide: 29 * `ping_interval` - 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 `0`, or excluding this setting.30 * `height` - The height of the container that Form is rendered into, including the unit. Useful if the Form does not have a natural height. Examples: `800px`, `10em`, `75vh`.31 30 32 **Example** 31 * **ping_interval** - 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 `0`, or excluding this setting. 32 * **height** - The height of the container that Form is rendered into, including the unit. Useful if the Form does not have a natural height. Examples: `800px`, `10em`, `75vh`. 33 34 **Examples** 33 35 34 36 Render a Project: … … 46 48 A pre-written script using standard methods from the [DriveWorks Live Client SDK](https://webapi.driveworkslive.com/help/client/), running on your own server, performs a login and renders the configured Form. 47 49 48 The script will not send any credentials during login, so * a default user must be specified* in DriveWorksConfigUser.xml.50 The script will not send any credentials during login, so **a default user must be specified** in **DriveWorksConfigUser.xml**. 49 51 If a default user is not set server-side, the connection will not be authorized. 50 52 … … 54 56 Clear warnings will be shown if any errors are made in the config or during connection. 55 57 56 For alternative examples on how to render a DriveWorks Form, see our public [Client SDK Examples](https://webapi.driveworkslive.com/home.html) .58 For alternative examples on how to render a DriveWorks Form, see our public [Client SDK Examples](https://webapi.driveworkslive.com/home.html) and our [Official GitHub](https://github.com/driveworks). 57 59 58 60 == Frequently Asked Questions == … … 61 63 62 64 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. 63 For configuration guidance, see: https://docs.driveworkspro.com/Topic/IntegrationThemeSelect65 For more information and configuration guidance, see: [](https://docs.driveworkspro.com/Topic/IntegrationThemeLive) 64 66 65 67 = Can I use multiple embeds on one page? = 66 68 67 Yes - however they will *all share the same client library script*. Only *1* version of the library can be loaded on the same page. 69 Yes - however they will **all share the same client library script**. 70 Only **1** version of the library can be loaded on the same page. 68 71 The first server url found in the content will be used to load the client library script. 69 72 … … 81 84 82 85 To troubleshoot, ensure that: 86 83 87 * The configuration in your shortcode is correct. 84 * Your Integration Theme server is configured correctly in DriveWorksConfigUser.xml88 * Your Integration Theme server is configured correctly in **DriveWorksConfigUser.xml** 85 89 * Your Integration Theme server is running, and allows connections from this site. 86 * The Group Alias has a default username and password set in DriveWorksConfigUser.xml90 * The Group Alias has a default username and password set in **DriveWorksConfigUser.xml** 87 91 88 92 For more setup instructions, see: 93 89 94 * [Selecting the Integration Theme](https://docs.driveworkspro.com/Topic/IntegrationThemeSelect) 90 95 * [Configuring the Integration Theme](https://docs.driveworkspro.com/Topic/IntegrationThemeSettings) … … 92 97 == Screenshots == 93 98 94 1. Enter the shortcode 95 2. Configure connection details and other options96 3. Save and view Form rendered in your content99 1. Enter the shortcode into text content. 100 2. Enter connection details and other configuration options. 101 3. Save and view the Form rendered in your content. 97 102 98 103 == Changelog == 99 104 100 = 1.0 = 101 * Initial release - with Project & DriveApp support. 105 = 1.0.1 = 106 107 * Fixed: Grammatical errors and markdown syntax 108 109 = 1.0.0 = 110 111 * Initial release - with Project & DriveApp support
Note: See TracChangeset
for help on using the changeset viewer.