Promotion Proxy

The Promotion proxy lets you display random micro content items in HTML5 output. Results are dynamic, generated at runtime in the browser, using the search engine. You might use a Promotion proxy to display information about relevant products, events, new features, etc.

For many more details about Flare's micro content proxies and containers, their possible uses, and how they compare with each other, see Micro Content Containers and Proxies.

How to Insert a Promotion Proxy

  1. Open a topic or template page.

    If you want the micro content to display in multiple topics, you will usually want to insert the proxy into a template page so that it is automatically used by many (or all) topics (see Template Pages). However, you can insert the proxy into an individual topic if you want (see Opening Topics).

    If you want the micro content to display in search results, you need a topic where you have also inserted a search results proxy. See Creating Search Results.

  2. (Optional) If you want to position the micro content results in a particular on the page (e.g., right side), you might consider creating and inserting a responsive layout, with the proxy inserted into the appropriate cell. See Responsive Layouts.

  3. Select Insert > Proxy > Promotion Proxy.

  4. (Optional) In the Proxy Title field, you can enter title text, which is displayed at the top of the micro content.

  5. If you have added a Promotion skin component to your project and want to use it to control the look of the micro content container, you can select it from the Skin File field. See Editing Skin Settings and HTML5 Skin Styles.

    If you do not select a Promotion skin component in this field, Flare uses the first one it finds in your project (if one exists). Otherwise, Flare uses the settings in your main HTML5 skin.

  6. If you have created a separate stylesheet for micro content purposes, you can select Allow micro content stylesheets (see Single-Sourcing Micro Content Using Styles). Otherwise, your main stylesheet will be used.

  7. Click the What micro content to include drop-down, and select one of the options.

    • All micro content files Every phrase from all of your micro content files may be included.
    • Specific micro content files In the drop-down(s), choose one or more micro content files. Every phrase from those files may be included.

    • Micro content with meta tags In the additional drop-down(s), choose specific meta tag names and corresponding values. Micro content phrases that match may be included. For more details, see Meta Tags.

  8. Click the How micro content is included drop-down, and select the terminology method that you want the search engine to use to match a micro content phrase, thus determining the content results for the proxy.

    • All micro content Every micro content phrase meeting the criteria from the first filter may be included in the results.

    • Topic title The title that is set automatically or manually in the topic properties (and added inside the topic’s <head> tag) may be used in the results if it matches a micro content phrase.

      Note This option is useful primarily when inserting the proxy into a template page or topic, as opposed to including it in search results. If you wanted to include it in a custom search results page, you would want to make sure the topic holding the Search Results proxy had the topic title in question added to its properties.

    • Search query The keyword(s) entered by the end user when performing a search may be used if it matches a micro content phrase.

      Note This option is useful primarily when inserting the proxy into custom search results topic (which includes a Search Results proxy), as opposed to a template page or topic. That's because the keyword relies on an actual search performed by the end user in the output.

    • Meta tag value The meta tag name that you select from a meta tag set file may be used in the results if it matches a micro content phrase.

      Note This option is useful primarily when inserting the proxy into a template page or topic, as opposed to including it in search results.

      When using this option, you should associate the topic(s) in question with a value from the meta tag, and the micro content phrase should match that value text.

      If you want to include it in a custom search results page, make sure the topic holding the Search Results proxy is associated with the meta tag value in question.

    • Custom text Any text you provide in this field may be used in the results if it matches a micro content phrase.

      Note This option can be useful when inserting the proxy into a template page, topic, or custom search results page. You would probably use this option if you always wanted the same micro content phrase/response to be shown in the output.

  9. You can use the Limit number of results field to specify how many matching micro content results are shown on the page.

  10. Click OK. The proxy is added.
  11. Click Save the active file. to save your work.