Installation

To install YouTube Channel Pro, log-in to admin area Extensions > Extension manager > Install, choose "Upload package file" and choose youtubechannelpro-package.zip.

Warning Make sure that you choose not the file you downloaded from AllForJoomla, but the file inside the main archive.

After the package installataion you need to activate the plugin "System - YouTube Channel Pro". To do that go to Extensions > Plugin manager find and activate plugin "System - YouTube Channel Pro".

Activation

Updating this plugin is important due to bugfixes and new features. To set up automatic updates for the YouTube Channel Pro, please follow these steps:

  1. Open the component settings: Components > YouTube Channel Pro > Options
  2. Paste your Premium License Key into the "Premium License key" field. You can find this key inside your account on AllForJoomla.com -> Purchased extensions

After saving your website will automatically check for updates of the YouTube Channel Pro.

Warning The update will install only if you have active support otherwise it will throw an error. There are only 6 months of support included in the purchase price. To extend the support please choose "Extend support" inside your account on AllForJoomla.com -> Purchased extensions.

Create a widget

Widget creation and widget management is performed in admin section Components > YouTube Channel Pro.

To create or modify existing widget, just use integrated visual builder.

  1. First, enter the YouTube channel URL or @name.
  2. If everything is ok, you can customize the widget.

After creating a widget you will see it's shortcode in the widgets list. You need to place this shortcode in the place where you want this widget to be displayed. More about shortcodes in the "Shortcode" section.

Shortcode

In the admin section of your website Components > YouTube Channel Pro you can see a list of existing widgets. In the "Shortcode" column you can see a shortcode of every widget.

This shortcode you need to copy and paste to the place of your website where you want to see the widget. This shortcode you can paste inside the content (article), module html or even into the template files.

Translation

Quick extension translation

By quick translation we mean translating only some labels displayed in the widget.

To translate those labels you can use Joomla Language Overrides.

The language constants you need to override are:

  • COM_YOUTUBECHANNELPRO_VIEWS
  • COM_YOUTUBECHANNELPRO_SUBSCRIBERS
  • COM_YOUTUBECHANNELPRO_VIDEOS
  • COM_YOUTUBECHANNELPRO_SHOW_MORE
  • COM_YOUTUBECHANNELPRO_SHOW_LESS
  • COM_YOUTUBECHANNELPRO_LOAD_MORE
  • COM_YOUTUBECHANNELPRO_NO_VIDEOS_FOUND

To create language overrides follow these steps:

  1. Go to Extensions -> Language -> Overrides
  2. Select your website language (administrator) in the filtering
  3. Create new override by clicking "New" button
  4. Copy the desired constant for override (constants are listed previously) and paste it into the "Language Constant" field
  5. Write your translation of the constant into the "Text" field
  6. Select the "For Both Locations" checkbox
  7. Save the override

Repeat those steps for every language constant that you want to override translation.

Full extension translation

You can translate the plugin into desired language by translating the language files, renaming and putting them into specific folder:

  • /administrator/language/en-GB/en-GB.com_youtubechannelpro.ini
  • /administrator/language/en-GB/en-GB.com_youtubechannelpro.sys.ini

For example if you translating it to Italian language, you need to:

  1. Copy mentioned files, rename them to it-IT.com_youtubechannelpro.ini and it-IT.com_youtubechannelpro.sys.ini
  2. Translate new files in to Italian language
  3. Put them to the folder /administrator/language/it-IT/