Edit online

Adding Oxygen Feedback to WebHelp Generated from Oxygen XML Editor/Author

To install Oxygen Feedback in your WebHelp output generated using a transformation scenario from Oxygen XML Editor or Oxygen XML Author, use this procedure:

Prerequisites

  • You must have an installed version of Oxygen XML Editor or Oxygen XML Author with a valid license.
  • To install and manage Oxygen Feedback Cloud, you will need to choose a subscription plan during the installation procedure. To see the subscription plans prior to installing the product, go to: https://www.oxygenxml.com/oxygen_feedback/buy_feedback.html.
    Notice: If your subscription expires or if the number of page views allowed by your plan is exceeded for a particular month, you will receive a notification and the comments component will be disabled until the subscription is renewed/upgraded or until the end of the month (in the case of exceeding the page views limit).

Installation Procedure

  1. Log in to your Feedback account from the login page (https://feedback.oxygenxml.com/login). You can click on Log in with Google or Log in with Facebook to create an account using your Google or Facebook credentials or click the Sign Up tab to create an account using your name and email address.

    Step Result: If this is your first time logging in and you have not yet created a site configuration, you are directed to a Welcome page. Otherwise, you are directed to the Dashboard page.

  2. Click the Add your first site button to create a site configuration (if you are on the Dashboard page, click the Add site link in the top-right corner of the Sites pane). If you have not already selected a subscription plan, you will be directed to a page where you can choose from several options (you will also have the opportunity to choose the types of notifications you want to receive).
  3. In the Settings page, enter a Name and Description for the site configuration. Some optional settings can be adjusted according to your needs. For more details, see the Settings Page topic. Click Continue.

  4. In the Version page, you must specify a version and the base URL from your website where the WebHelp output is deployed. The Name field is where you specify the version name or identifier. This is helpful if there will be multiple versions for your output. For example, if your published output is documentation for a product that has multiple released versions, each version probably has its own published documentation. In this case, each published version requires a different configuration since the version and base URL would be different for each of them.

    The Site base URL field is where you specify the base URL for the website where you publish your output. For WebHelp output, for example, it is the URL where your WebHelp output is deployed. Comments will only be displayed on pages within the hierarchy of the specified base URL. For more details, see the Version Page topic. Click Continue.

  5. In the Installation page, choose the Install Feedback in WebHelp output generated from Oxygen OXL Editor/Oxygen XML Author option.
  6. Copy the generated HTML fragment from the Installation page in the admin UI.

  7. In Oxygen XML Editor/Author, open the Configure Transformation Scenario(s) dialog box using the toolbar button in the DITA Maps Manager.

  8. Select and duplicate the DITA Map WebHelp Responsive scenario.

  9. Go to the Feedback tab, click the Edit button located at the bottom-right of the dialog box, and paste the HTML fragment that was copied to the clipboard.

  10. Run the transformation and deploy the WebHelp output to a web server.

Install Feedback Using a Publishing Template

It is also possible to install Oxygen Feedback using an Oxygen Publishing Template:
  1. Complete steps 1 through 4 in the procedure above.
  2. In the Installation page, choose the Install Feedback in WebHelp output generated from a command line option.
  3. In Oxygen XML Editor/Author, create an XML file (for example, feedback-install.xml) on disk with the content generated in the Installation page from the Feedback admin UI.
  4. Create a Publishing Template, if you have not already done so. If you need help, see Working with Publishing Templates.
  5. Copy the newly created XML file to a folder inside the publishing template's root folder.
  6. Open the template descriptor file associated with your publishing template and add a reference to the newly created XML file in the html-fragments section.
    <publishing-template>
 ...    
  <html-fragments>
    <fragment file="custom-template/feedback-install.xml" 
     placeholder="webhelp.fragment.feedback"/>
  </html-fragments>

  7. Open the Configure Transformation Scenario(s) dialog box using the toolbar button in the DITA Maps Manager and duplicate the DITA Map WebHelp Responsive scenario.

  8. Click the Choose Custom Publishing Template link and select your template.
  9. Click OK to save the changes to the transformation scenario.

  10. Run the transformation and deploy the WebHelp output to a web server.

Tip:

To see a demonstration of how to install Oxygen Feedback in WebHelp output generated from Oxygen XML Editor, watch our installation video: