1.The Dynamic Content Builder for WordPress #

Cosmos takes the concept of building personalized landing pages with URL parameters to the next level by offering unprecedented levels of control and virtually unlimited combinations of content.

Match content by taxonomy terms from your site and provide semi random content or, match directly by title, slug or id.

Use the text replacement capabilities of Cosmos to dynamically alter any aspect of a page, product, post, or other content type using URL parameters, UTM codes and keywords.

2.Quick Start #

  1. Install plugin
  2. Activate License – in settings page
  3. Add url parameter – in settings page
  4. Add new WordPress page
  5. Click Cosmos Shortcode button in editor
  6. Set following parameters:
    • Content type – post
    • Renderby – shortcode
    • Shortcode – cosmos_post
  7. Click Build Shortcode
  8. Click Add Shortcode to Page
  9. Save Page
  10. Open page

3.Installing Cosmos Plugin #

  • Navigate to your WordPress dashboard
  • From the left side menu, roll over ‘Plugins’. Click ‘Add New’ from the fly out menu.
  • Click ‘Upload Plugin’
  • Click ‘Choose File’. Find the zip file for this plugin from your file system and click ‘Open’
  • Finally, click ‘Install Now’
  • Activate Plugin after it has been installed
  • If you are using WP-Engine as host, set Orderby Rand option to enabled in WP-Engine section of dashboard.
    Cosmos Plugin can still be used without Random ordering in many cases this is preferred, especially if your content is organized well – many other ordering options are available in the dropdown. If you do not enable OrderBy Rand in WP-ENGINE, the ordering will default to date.

Notes on Installation:

Cosmos Plugin adds Categories and Tags to Attachments and Pages. This means that you have access to taxonomies for pages and attachments ( images in the media library ). Cosmos uses taxonomies to match content with incoming URL parameters.

If you need to match pages or attachments to incoming URL parameters, you need to add terms ( category names or tag names or both ) to your pages and attachments.

3.1.Activate License #

The first step in the setup of Cosmos Plugin should be the activation of your product license. Doing so will ensure that you will not miss any important updates to the plugin by enabling automatic updates. License will also be checked if you need support.

3.2.URL Parameter Definitions #

Cosmos will work in a rudimentary way without the addition of URL parameters, but to get the most out of the plugin, you need to add at least one that will be used to match content from your site.

Enter the URL parameter that will be used to generate content in the URL Parameter field, once the parameter has been entered, click the ‘Add New URL Parameter’ button.

The parameters should match what you have set up in your third party advertising that gets passed to the landing page, just the parameter, no special characters and no values.

Example:

utm_source
utm_medium
utm_campaign
utm_content
utm_term

3.3.Rendering Settings #

These settings are optional, but recommended. Cosmos content blocks look best when they are rendered using shortcodes.

Cosmos pre-populates shortcodes for standard content types present in every WordPress installation. These can be used immediately without further need for settings changes.

Additional, non standard content types will not have any shortcodes pre-entered in the settings page and will have to be entered manually.

3.4.Advanced Settings #

Advanced Term Options

Advanced Term Options, when set to “TRUE” enables a very powerful set of features for dynamic content creation.

This includes Limiting results to specified terms, and also excluding terms that are specified in text fields in the shortcode builder interface.

Allow Pretty Permalinks

Allow Pretty Permalinks, when set to “TRUE” enables the use of pretty permalinks for URL Parameters and adds new URL rewrite rules to your WordPress installation to handle URL parameters that you have entered into the Cosmos Settings.

The rewrite rules allow for URL parameters to be parsed out of pretty permalinks – example:

http://yoursite.com/landing-page/?clothing=hoodies — this is the default way of handling URL parameters
http://yousite.com/landing-page/clothing/hoodies — with the URL Parameters as Pretty permalinks option enabled, this will behave in the same way as the previous URL string example.

WooCommerce Marketing Spots

( only present when WooCommerce is installed )

WooCommerce Marketing Spots, when set to “TRUE” will add two new meta boxes to WooCommerce product editing pages – the meta boxes are able to take any kind of content, including Cosmos Shortcodes.

Use these to display custom banners above the product, blog posts, testimonials, custom cross sells and more below the product.

The marketing spots are product specific, so will need to be authored for each individual product.

Hide WooCommerce Related Products

( only present when WooCommerce is installed )

Hide WooCommerce Related Products, when set to “TRUE” will prevent WooCommerce powered related products from appearing below products on product pages.

This is a global setting and affects all products in your store.

4.Setup Cosmos Plugin #

After Cosmos has been installed and activated, a new menu item in your WordPress dashboard will appear: ‘Cosmos’

Clicking this menu item will take you to the Cosmos Plugin settings page. The first time you visit the page, a tour will open that will guide you through the basic setup of the plugin.

Subsequent visits to the settings page will not automatically show the tour, but it is accessible via the menu item in the Cosmos Settings page.

5.Using Cosmos Plugin #

Cosmos Plugin adds a new button to the content editor:

‘Build Cosmos Shortcode’ — This button opens a dialog box that will build the shortcode and add it to the page automatically.
To add a dynamic content block to a post, page or other content type:

  1. Click the ‘Build Cosmos Shortcode’ button. This will open a dialog.
  2. In the dialog, there are several select drop downs that contain parameters. The only parameter that is required is Content Type.
  3. Choose a content type
  4. Click ‘Build Shortcode’
  5. Click ‘Add Shortcode To Page’

This will add a simple dynamic content block – more control is available through the use of the other parameters in the shortcode builder.

6.Beaver Builder #

Cosmos integrates with Beaver Builder

To add a Cosmos dynamic content block to a page built with Beaver Builder, use a Text Editor Module from Beaver Builder:

Next, click on the ‘Build Cosmos Shortcode’ button to open the Cosmos Shortcode Composer

Finally, build a Cosmos Shortcode using the shortcode composer, and click ‘Add Shortcode to Page’

7.Cosmos Plugin Shortcode Parameters #

The Cosmos shortcode builder interface has several parameters that are used to determine what type and quantity of content will be displayed, how it will be rendered, what to display when no match is found, and content filtering to produce an infinite number of dynamic content combinations.

Use this section as a reference to help further understand what is being shown in the tutorial videos.

7.1.Choose Content type #

Required or Optional :

Required

Purpose :

Select the type of content to be displayed in this dynamic content block.

Options :

Each of the content types available on your WordPress installation will be listed as an option.

Default Value :

No default value

7.2.Default Parameter Value Output: #

Required or Optional :
Optional
Purpose :
If content type for this shortcode instance is set to URL Parameter Output, you have the option using this field to enter default text.
Options :
Text field
Default Value :

Empty

7.3.Display Full Content or Excerpt #

Required or Optional :
Required
Purpose :
Choose whether to display an excerpt from a post, or the full content
Options :

  • Excerpt
  • Full Content

Default Value :

Excerpt

7.4.Render By #

Required or Optional :
Optional
Purpose :
Determine the method of rendering the content blocks.
Options :
Default – no formatting
Shortcode – if you registered shortcodes for a given content type, then you can choose one by selecting this.
Default Value :

No default value

7.5.Select Shortcode #

Required or Optional :
Optional
Purpose :
Select a registered shortcode to render a content type.
Options :
Shortcodes registered in settings page will show here.
Default Value :

No default value

7.6.Set Quantity #

Required or Optional :
Required
Purpose :
Set the max number of content blocks rendered by this shortcode instance.
Options :
Numbers, from 1 to the maximum number of posts allowed on a page, as set in your website settings.
Default Value :

1

7.7.Set Orderby Parameter #

Required or Optional :
Required
Purpose :
Select ordering method for content return
Options :

  • Random
  • Name
  • Date
  • Modified
  • Author

Default Value :

Random

7.8.Title Links to Post #

Required or Optional :
Optional
Purpose :
Choose whether the post title in the return is also a link to the post
Options :

  • True
  • False

Default Value :

None

7.10.Choose URL Parameter #

Required or Optional :
Optional
Purpose :
Select the URL parameter that this shortcode instance will target.
Options :
URL parameters from Cosmos Settings.
Default Value :

None

7.11.Using Advanced Term Options #

By default Cosmos Plugin will return completely random content chosen from all categories, tags and any other taxonomies. Enabling the advanced term parameters gives you the ability to limit the queries by either excluding defined terms or limiting the results to defined terms.
You can also choose to completely ignore incoming URL parameters. This is useful if you want to display content that does not need to be custom for visitors. This is best used when combined with either limiting the terms or excluding terms.
The limit and exclude terms parameters are taxonomy agnostic, meaning the term name can apply to any taxonomy such as tag, category, product-category, etc. There is no need to specify which taxonomy the term is in.
To enable this feature, navigate to the Cosmos settings page in the dashboard and click on the menu item for ‘Advanced Options’.
Select Enable from the radio buttons on the page.

To limit random results to certain terms:

  1. Click ‘Build Cosmos Shortcode’ from the post edit screen
  2. Choose a content type
  3. Click ‘Show Advanced Options’
  4. Select ‘Limit Terms’
  5. Enter term names from any taxonomy, separated by a comma
  6. Click ‘Add Shortcode To Page’

To set random results to exclude certain terms:

  1. Click ‘Build Cosmos Shortcode’ from the post edit screen
  2. Choose a content type
  3. Click ‘Show Advanced Options’
  4. Select ‘Exclude Terms’
  5. Enter term names from any taxonomy, separated by a comma
  6. Click ‘Add Shortcode To Page

Ignoring Incoming URL parameters:

  1. Click ‘Build Cosmos Shortcode’ from the post edit screen
  2. Choose a content type
  3. Click ‘Show Advanced Options’
  4. Select ‘True’ from the ‘Ignore Incoming URL Parameters:’ section
  5. Click ‘Add Shortcode To Page

7.12.Limit Terms #

Required or Optional :
Optional
Purpose :
Choose terms from your taxonomies that the dynamic content must be part of.
Options :
Text field, enter terms separated by comma.
Default Value :

Empty

7.13.Exclude Terms #

Required or Optional :
Optional
Purpose :
Choose terms from your taxonomies that the dynamic content must not be part of.
Options :
Text field, enter terms separated by comma.
Default Value :

Empty

7.14.Match Content By Title, Slug, Term, or Post ID #

Required or Optional :
Optional
Purpose :
Select method of matching content from your website.
Options :

  • Taxonomy Terms
  • Post Title
  • Post Slug
  • Post ID

Default Value :

Taxonomy Terms

7.15.Ignore Incoming URL Parameters #

Required or Optional :
Optional
Purpose :
Choose whether to ignore incoming URL parameters in the content fetch
Options :

  • True
  • False

Default Value :

False

Help Guide Powered by Documentor
Suggest Edit