ochCall2Action (content plugin)

Requirements

• Basic Joomla! knowledge available between the chair and the keyboard :)

Installation is easy!

1. Download the plugin
2. in the Back-end go to menu Extensions > Manage
3. in the tab [Upload file package] click [browse]  and select your downloaded plugin
4. click [Upload & Install], wait for the installation to finish

Configuration

1. Call2Action content preparation:
   • In the back-end create a content category that you will use for you Call2Action content articles
   • Create (and publish) Joomla! articles and assign them to the category created in previous step
2. Plugin configuration:
   • in the back-end go to menu Extensions > Plugins
   • search / locate the 'ochCall2Action' content plugin
   • open the plugin
   • in the tab [Plugin] set status to [Enabled]
   • in the tab [Call2action content] configure your Call2action category (the category created in step 1.) > look at the tool-tips for information about what each setting does
   • in the tab [Auto Call2action] configure the automatic insertion of the Call2action content on selected categories (top, bottom, both position) or views
   • click [Save & Close] and you are good to go

Advanced Replacements

ochCall2Actions comes out-of-the-box with fixed insertion positions. But in some cases these predefined positions are not enough and you want to target a specific position on your page.

For this you can use Advanced Replacements.

A Advanced Replacement is a search string (regex) that will  point to the position that you want to insert the ochCall2Action articles in: you can then replace the search with the article or inject the article before or after the search result.

As an example: you want to add an ochCall2Action article after ever 3rd <p> element in your article. You can then configure the Advanced Replament as follows:

• Match regex: /<p>.+?<\/p>/i
• Action: Add after
• Occurance: 3

So what will happen here? ochCall2Action will use the regex "/<p>.+?<\/p>/i" on your article text. This regex will look for a string that starts with <p> then has any text (.+?) and ends with </p> case insensitive. It will find one or more and after the 3rd occasion it will add the ochCall2Action article.

This is very powerful feature as it opens up ANY position and because you can have multiple replacements you are not limited to only one position.

So you can add an ochCall2Action article after every image, before the 2nd h2 element, you can even replace every occurrence of any word in your text: the sky is the limit.

Please note that creating and using regex syntax is an advanced topic and this is not a learning guide on how to create a good regex. There are a lot of good resources on the internet explaining regex and how to use them.

Manually add Call2Action content in your blog / article

You can place the Call2Action content automatically on the top or bottom (or both) positions of the selected article categories, but the real power lies in the manual placement of the Call2Action content:

1. open the blog / article (or even HTML module!) that you want to place the Call2Action content in
2. insert {call2action} into the location where you want to automagically display the Call2Action content
3. click [Save & Close]
4. when surfing to your article / blog on the front-end, the Call2Action content should automagically show up: Cool :)