Plugin Directory

Changeset 2668381


Ignore:
Timestamp:
01/28/2022 04:17:40 PM (4 years ago)
Author:
driveworks
Message:

Release 1.0.1

File:
1 edited

Legend:

Unmodified
Added
Removed
  • driveworks-shortcode-form-embed/trunk/readme.txt

    r2668241 r2668381  
    22Contributors: driveworks
    33Tags: driveworks, driveworks live, embed, driveapp, project, shortcode, integration theme, integration
    4 Stable tag: 1.0.0
     4Stable tag: 1.0.1
    55Requires at least: 4.0
    66Tested up to: 5.8
     
    1919> 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.
    2020
    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.
    2425* Either:
    25   * `project_name` - The name of the Project to render
    26   * `drive_app_alias` - The name of the DriveApp to render
     26  * **project_name** - The name of the Project to render
     27  * **drive_app_alias** - The name of the DriveApp to render
    2728
    2829Optionally 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`.
    3130
    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**
    3335
    3436Render a Project:
     
    4648A 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.
    4749
    48 The script will not send any credentials during login, so *a default user must be specified* in DriveWorksConfigUser.xml.
     50The script will not send any credentials during login, so **a default user must be specified** in **DriveWorksConfigUser.xml**.
    4951If a default user is not set server-side, the connection will not be authorized.
    5052
     
    5456Clear warnings will be shown if any errors are made in the config or during connection.
    5557
    56 For alternative examples on how to render a DriveWorks Form, see our public [Client SDK Examples](https://webapi.driveworkslive.com/home.html).
     58For 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).
    5759
    5860== Frequently Asked Questions ==
     
    6163
    6264Yes - 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/IntegrationThemeSelect
     65For more information and configuration guidance, see: [](https://docs.driveworkspro.com/Topic/IntegrationThemeLive)
    6466
    6567= Can I use multiple embeds on one page? =
    6668
    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.
     69Yes - however they will **all share the same client library script**.
     70Only **1** version of the library can be loaded on the same page.
    6871The first server url found in the content will be used to load the client library script.
    6972
     
    8184
    8285To troubleshoot, ensure that:
     86
    8387* The configuration in your shortcode is correct.
    84 * Your Integration Theme server is configured correctly in DriveWorksConfigUser.xml
     88* Your Integration Theme server is configured correctly in **DriveWorksConfigUser.xml**
    8589* 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.xml
     90* The Group Alias has a default username and password set in **DriveWorksConfigUser.xml**
    8791
    8892For more setup instructions, see:
     93
    8994* [Selecting the Integration Theme](https://docs.driveworkspro.com/Topic/IntegrationThemeSelect)
    9095* [Configuring the Integration Theme](https://docs.driveworkspro.com/Topic/IntegrationThemeSettings)
     
    9297== Screenshots ==
    9398
    94 1. Enter the shortcode
    95 2. Configure connection details and other options
    96 3. Save and view Form rendered in your content
     991. Enter the shortcode into text content.
     1002. Enter connection details and other configuration options.
     1013. Save and view the Form rendered in your content.
    97102
    98103== Changelog ==
    99104
    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.