Joomla 3.0 Integration

2017-09-05

Disclaimer

Due to the large number of third party applications and Content Management Systems (CMS), 1WorldSync does not provide support for third party applications or CMS. This guide is provided as an aide for guidance and suggestions for integration. 1WorldSync is not liable for any actions, damage or loss. If you require support for your third party application or CMS, please contact the owner or company that produced the application for assistance.

Getting Started with Joomla Integration

In Joomla 3.0, when adding content and saving, there are various elements that Joomla will remove from your content by default as a security precaution. Joomla will remove any <script> or <iframe> elements. There are some steps required in order to integrate Microsoft DCCN, ContentCast or DataSource Cloud.

There are a variety of solutions:

  1. Temporarily disable your editor
  2. Change editor settings to allow JavaScript
  3. Set “No Filtering” for SuperAdmins.
  4. Install a different WYSIWYG Editor.

Disable your WYSIWYG Editor – Easiest and fastest method

  1. Login to Joomla Administrator
  2. Go to Users -> Edit your own account
  3. Set the user’s Editor preferences to “Editor – None” temporarily when adding JavaScript.
  4. Click Save and Close

Allow JavaScript with TinyMCE editor

  1. Login to Joomla Administrator
  2. In the top menu, hover over Extensions and click Plug-ins
  3. Click on Editor – TinyMCE
  4. From the list of Basic Options, move script from Prohibited Elements to Valid Elements.

  5. Then add “div[*]” to Extended Valid Elements to allow empty div containers

  6. Click Savein the top right menu. Now that you have removed script from the Prohibited Elementssetting, you can add JavaScript code for banners, product page scripts or showcases to your articles.

Allow JavaScript for specific user roles

SuperAdmins are allowed to post any content tags to the site, assuming that your preferred editor has already been configured. If your account is not a SuperAdmin role, you will need to modify your role to remove the HTML filtering as well.

  1. In the top menu, click System and click Global Configuration

  2. Click on the Text Filters tab

  3. For your Super Users ensure No Filtering is already selected and update your group as well.

Install a WYSIWYG editor that supports JavaScript

Download a WYSIWYG Editor that supports JavaScript and HTML

JCE – http://www.joomlacontenteditor.net/

TinyMCE – http://www.tinymce.com/

Integrate Showcase for Joomla

Before adding a Brand Showcase, make sure you have configured Joomla to support JavaScript.

  1. In the top menu, select Content -> Article Manager -> Add New Article
  2. Enter the Title: Lenovo Showcase (example)
  3. Select the category
  4. In Article Text, Paste your showcase code such as:

    Showcase Code Example

    <div id="ccs-brand-showcase"></div>
  <script type='text/javascript'>
    var ccs_cc_args = ccs_cc_args || [];
    // My Lenovo Brand Showcase
    ccs_cc_args.push(['mf', 'Lenovo']);
    ccs_cc_args.push(['lang', 'en']);
    ccs_cc_args.push(['market', 'US']);
    (function () {
    var o = ccs_cc_args; o.push(['_SKey', 'ABC1234']); o.push(['_ZoneId', 'ABC1234asdasd']);
    var sc = document.createElement('script'); sc.type = 'text/javascript'; sc.async = true;
    sc.src = ('https:' == document.location.protocol ? 'https://' : 'http://') + 'cdn.cs.1worldsync.com/jsc/h1ws.js'; var n = document.getElementsByTagName('script')[0]; n.parentNode.insertBefore(sc, n); })(); </script>
  5. Click Save and Close
  6. Preview the page.

Integrate Campaign Banners for Joomla

By default, Joomla 3.0 does not allow JavaScript code and empty div tags in Articles. Before proceeding with the steps below, you will need to follow the steps under the Allow JavaScript with TinyMCE editor section in the Joomla 3.0 Integration Guide.

How to add the Campaign Banners to an Article

  1. In the DCCN portal, click Set Up Web Campaigns.
  2. Choose your topic and banner size. Click Get Code and copy the code.
  3. In your Joomla Administrator section, create a new Article.
  4. Click Toggle Editor

  5. Copy and paste the DCCN Code available in the DCCN Portal

  6. Click Save

By default, Joomla 2.5 does not allow JavaScript code in the “Custom HTML” Module. Before proceeding with the steps below, you will need to follow the steps under the Allow JavaScript with TinyMCE editor section in the Joomla Integration Guide. You will need to download a 3rd party module such as:

How to add the Campaign Banners as a Custom Module

Steps for Custom Javascript Module

Installation and Setup

  1. Download the Custom Javascript Module
  2. Go to Extensions -> Extension Manager
  3. Upload & Install the “mod_custom_js16.tar” file

How to add the Campaign Banners

  1. In the DCCN portal, choose your topic and banner size. Click Generate and copy the code.
  2. In your Joomla Administrator section, click Extensions -> Modules
  3. Click New
  4. Choose “Custom Javascript”
  5. for the Title, add a description such as “Microsoft DCCN Front Door Banner – 300×250”
  6. Set Show Title to “Hide”
  7. Choose the position of the where the banner should appear in your Joomla template.
  8. Under Basic Options, copy and paste the DCCN Code available in the DCCN Portal
  9. Click Save