Jumat, 13 Februari 2009

JA Teline II - Userguide

JA Teline II - Userguide
  • Following the spirit and inspiration of JA Teline, JoomlArt now introduce JA Teline II with great features and functions for your Joomla! site.
  • For users who start your Joomla! site at the beginning, I recommend you using QuickStart package of JA Teline II, named as ja_teline_ii_quickstart.zip. For instruction how to use JoomlArt quickstart package, please check the QuickStart guide
  • For users who new to Joomla!, there are many useful documents available at http://joomla.org about Joomla! and how to use, please spend some time to check them out.
    Here is some other guides that may useful for you:
  • For users that already have a site with contents and other extensions installed, please follow my instruction below to understand how JA Teline II works:

I. TEMPLATE

1.1 Template Installation

After downloading JA Teline II package and extract it, you will find template package named: ja_teline_ii_template.zip

Proceed installation of JA Teline II as other normal Joomla! templates. If you don't know how to do installation or set a template as default, please check the How to install Joomla! template guide.

After installing and setting JA Teline II as default template, your site should look like this:


To see positions located in site, in Navigation toolbar input string "?tp=1" at the end of site link



1.2 Template Configuration

To configure JA Teline II, On Admin panel, choose Extentions >> Template Manager, click on template name , you will see parameters of template.


In here, you can change all JA Teline II parameters as you wish.

Please hover your mouse to each parameter to see its explanation and details.


Please click here for JA Teline II module positions and its arrangement. Base on module positions, you can publish your modules on them to match JA Teline II style.

If you don't know how to create module position in Joomla!, please follow this guide

II. EXTENSION INSTALLATION

When extracting JA Teline II package, you will see the folder named Extensions. All extensions needed for Teline II template in here, there are 3 modules packages and 1 plugin package.

You check How to install Joomla! module guide and How to install Joomla! plugin guide for installation.

Now let's check what extensions came along with JA Teline II:
Note: [xx] before each extension is its postion.
  • [ja-news] JA News module version 1.3
  • [ja-news] JA News module FrontPage
  • JA HighSlide (this was embedded in the template, you don't need to install)
  • JA mooTab (embedded in the template)
  • JA Zin plugin
  • [left] JA_Catslwi (Categories Spotlight with Image)We'll check them one by one now.
  • [user5] All Videos module
We'll check them one by one now.

2.1. JA News Modules (mod_janews.zip)
[position: ja-news]

New version 1.3.0 of our JA News module now came with JA Teline II.



After installed, please go to Modules Manager and click on JA News 1.3.0 name:



Here is the setting of JA News on demo page



For each parameter, please hover your mouse on its title for more information.
On the settings, you will notice there's one parameter named Category (Section) ID and its setting
Quote:
13:red
14:orange
8:deepblue
12:cyan
5:green
9: pink
11:lime
Syntax for this is: :. ID can be sectionID or categoryID base on what you choose right above and color can be color English name in this list (red, cyan, deepblue, green, orange, pink, lime)).

2. JA News Frontpage Module (mod_janews_fp.zip)
[position: ja-news]
Rearrange frontpage contents (article choose to display on frontpage) of Joomla into Headline layouts like news portal. You can choose among 2 options layout.

JA News Frontpage is a part of JA News packages (JA News + JA News frontpage = JA News 1.3 and released with JA Teline II).

Do installation same as JA News above, after that, click on JA New FrontPage to go to configuration page.



This module position was ja-news. Above is the setting at demo page. Please make sure your settings are the same as shown.

You will notice that there's a param name Layout style.

When setting as default_fp.php, layout of JA News Frontpage will look like this:



and when set to headline_fp.php, layout of it will back to old style of JA News earlier version.



Here is the setting at demo page for Headline layout setting, these params only being used when layout select as headline_fp.php




2.3. JA Category Spotlight with Image (mod_ja_catslwi.zip)

[position: left]

This module will show specific content from a category in a very impressive way.

Goto Extensions >> Modules Manager and select Spotlight Module Content with Image


Here is the setting for this module at demo page:



When you put in CategoryID, all articles in that category will be shown as spotlight like this:


You can limit number of items to display in Number of Elements.
Module height specify the height of each content display:


For other parameters, simply hover your mouse over its title, you will see what it stands for.

4. JA ZIN PLUGIN (plg_jazin.zip)

This plugin will find all available section and categories in your Joomla site and create all menu items link to such section/categories. Once created, menus item will be set to publish status. You can delete or unpublish unnecessary menus.

Install it as other extensions. When done, please select Extensions >> Plugin Manager you will see JA Zin plugin with the name JA Section menu plugin in the list. Please make sure it enabled.


Click on its name to go to configuration page.
Here is the setting at Demo page:


Type in the menu name that you want to create at Menutype. After enable, you will see the menu has been create by click on Menu >>


This menu will be created base on your Section structure and Category you've had. If you have any changes in your section/category structure, please select Update Setting = Yes in JA Zin configuration page to make change to menu.
Note: JA Zin used to generate the menu tree for selected section or category. So after you've running it and have your desired menu, you can turn it off to save your resource and get a faster load for your site. If you lease it on, menu will be re-generated everytime your page loading.

Now we need to go back to Template Manager >> JA Teline II configuration page and select this menu to display.


2.4. ALL VIDEOS Module (Homepage URL)


Flexibly handle your content streaming with any type of video or audio. You can also save your server's bandwidth by embedding video or audio content uploaded on other servers (YouTube etc.)



Please follow this URL to download All Videos module.
JoomlArt has developed a file call playlist.php to handle the existed videos on your host, please check the setting bellow to understand how it works and how to use.



For more information about this module, please visit author homepage

2.5. JA MooTabs & JA HighSlide (embedded)
JA MooTabs was integrated in template, all you have to do is publish your desire modules to user6 position, it will be display in a tab on FrontPage. There's only one note for users who using JA MooTabs: All module published to user6 position MUST set Show Title >> On.

JA HighSlide was also embedded and applied to elements of the page:





If you want to add highslide to other elements on your page, please check out the document and API of HighSlide at:
Document: http://vikjavev.no/highslide/doc.php
API Reference: http://vikjavev.no/highslide/ref/
It's a bit difficult for non-developer user so I recommended you read the HighSlide document carefully before using it.

2.6. OTHERS
  • Login Module: Need to be published to ja-login position.
    Settings: Show Title: Yes. Menu Assigntment: All
  • Main Menu, Poll, Advertisement,... should be set to right position.
  • For Custom module, please read FAQ: how to create custom HTML module.
-------
After you done all above, the base frame of JA Teline II has been setup. We now need some modification in content to match the template layout and style.
You may want to add some module or custom module to position user8 and user9 to make your site look exactly like JA Teline II.


III. TYPOGRAPHY

As usual, JA Teline II came with a rich typography to give users more ability to customize content look and feel. Please check all JA Teline II typography here at JA Teline II Typography

IV. FREQUENTLY ASKED QUESTION

Q: How can I create module position in Joomla! 1.5.x?
A: There are many users don't know how to create module position in Joomla! 1.5.x, and here is how. Select module that you want to put to new position. In the configuration page, just click directly to the Position box (not the arrow button), you will notice it's typeable. Delete all and type in your desire position. After saved, your new position has been created and your selected module will be put in that postion.
{image}

Q: How can I make a custom HTML module?
A: In Module Manager, Click on New button {image}. Then select Custom HTML, and click Next. Fill your HTML code to Custom Output textarea and click Save. You will have a new Custom Module as you expected.

Q: Why I need to do many things to make template work? Why don't you just provide template only?
A: JoomlArt template is More than just a Template. When you download template package from JoomlArt, you will have all extensions included. The template simply will not be perfect without a hand of extensions. It will not only make your site more attractive but also provide users more features and ability to explore your site easier.

JA Teline II

JA Teline II - Userguide for Joomla! 1.0.x
  • For users who start your Joomla! site at the beginning, I recommend you using QuickStart package of JA Teline ii, named as ja_teline ii_quickstart_j10.zip. For instruction how to use JoomlArt quickstart package, please check the QuickStart guide
  • For users who new to Joomla!, there are many useful documents available at http://joomla.org about Joomla! and how to use, please spend some time to check them out.
    Here is some other guides that may useful for you:
  • For users that already have a site with contents and other extensions installed, please follow my instruction below to understand how JA Teline ii works:

I. TEMPLATE

1.1 Template Installation

After downloading JA Teline ii package and extract it, you will find template package named: ja_teline ii_template_j10.zip

Proceed installation of JA Teline ii as other normal Joomla! templates. If you don't know how to do installation or set a template as default, please check the How to install Joomla! template guide.

After installing and setting JA Teline ii as default template, your site should look like this:


To see position located in site, in Navigation toolbar input string "?tp=1" at the end of site link



1.2 Template Configuration

To configure JA Teline ii template, check How to configure Joomla! template guide!

You can change all JA Teline ii parameters as you wish.

JA Teline ii module positions are available here You just need to configure your modules to be loaded on those positions to match JA Teline ii style.

If you don't know how to create module position in Joomla!, please follow this guide

II. EXTENSION INSTALLATION

When extracting JA Teline ii package, you will see the folder named Extension with all extensions built in the JA Teline ii, including JA News, JA News FrontPage, AllVideos Reloaded, JA Category Spotlight with Image, JA Login modules and JA News, JA AllVideos, JA Zin mambots. That means when you install via template installer, you need to install them separately, then configure their positions as instructed in Template configuration section.

You check How to install Joomla! module guideand How to install Joomla! mambot guide for installation.

Extensions built in JA Teline ii comprise:
Note: [xx] stands for module position
  • [janews] JA News FrontPage module
  • [janews] JA News module
  • [user5] JA AllVideos Reloaded module
  • [left] JA Category SpotLight With Image module
  • [ja-login] JA Login module
  • JA New mambot
  • JA AllVideos mambot
  • JA Zin mambot
  • JA Highslide module (this was embedded in the template, you don't need to install)
  • JA Tabs module (this was embedded in the template, you don't need to install)

And extension details as follow:

2.1.JA News Frontpage Module (mod_janews_fp.zip)
[position: ja-news]

New version 1.3.0 of our JA News module now came with JA Teline II.

JA News Frontpage is a part of JA News packages (JA News + JA News frontpage = JA News 1.3).

Rearrange frontpage contents (article choose to display on frontpage) of Joomla into Headline layouts like news portal. You can choose among 2 options layout.

On demo, it looks like:


In Admin panel, go to Modules>Site Modules and click on module name ( JA News Frontpage )to go to configuration page.

Here is the setting of JA News Frontpage on demo:


Please hover your mouse to each parameter to see its explanation and details.

You will notice that there's a param name Layout style.


On demo, Layout style is default_fp.php

and when set to headline_fp.php, layout will back to old style of JA News earlier version.



Here is the setting at demo page for Headline layout setting, these params only being used when layout select as headline_fp.php



2.2.JA News Modules (mod_janews.zip)
[position: ja-news]

On demo, it looks like:


In Admin panel, please go to Modules>Site Modules and click on module name (JA News) to go to configuration page.

Here is the setting of JA News on demo:


For each parameter, please hover your mouse on its title for more information.
On the settings, you will notice there's one parameter named Category (Section) ID and its setting
Quote:
5:red
4:orange
9:deepblue
6:cyan
11:green
8: pink
7:lime
10:blue
Syntax for this is: :. ID can be sectionID or categoryID base on what you choose right above and color can be color English name in this list (red, orange, deepblue, cyan, green, pink, lime, blue)).

2.3. All Videos Reloaded Module (Homepage URL)
[postion: user5]
Flexibly handle your content streaming with any type of video or audio. You can also save your server's bandwidth by embedding video or audio content uploaded on other servers (YouTube etc.)



Please follow this URL to download All Videos module.
JoomlArt has developed a file call playlist.php to handle the existed videos on your host, please check the setting bellow to understand how it works and how to use.



For more information about this module, please visit author homepage

2.4. JA Category Spotlight with Image (mod_ja_catslwi.zip)
[position: left]

This module will show specific content from a category in a very impressive way.

On demo, it looks like:


In Admin panel, go to Modules >> Site Modules and click on module name (Spotlight Module Content with Image) to go to configuration page.

When you choose Category in Category ID dropdown list, all articles in that category will be shown as spotlight

You can limit number of items to display in Number of Elements.
Module height specify the height of each content display:


For other parameters, simply hover your mouse over its title, you will see what it stands for.

2.5. JA Login module (mod_japopupusertools.zip)
[position: ja-login]

On demo, it looks like:


In Admin panel, go to Modules >> Site Modules and click on module name (JA Popup User Tools) to go to configuration page.


2.6. JA News and JA AllVideos mambot (mab_janews.zip and mab_jaallvideos.zip)

JA News and JA AllVideos mambots came with JA News and JA AllVideos Reloaded modules.

To display JA News and JA AllVideos Reloaded modules on frontpage, you must enble JA News and JA AllVideos mambots first.

2.7. JA ZIN mambot (mab_jazin.zip)

This plugin will find all available section and categories in your Joomla site and create all menu items link to such section/categories. Once created, menus item will be set to publish status. You can delete or unpublish unnecessary menus.

In Admin panel, go to Mambots >> Site mambots click on module name (JA Section menu plugin) to go to configuration page.. Please make sure it enabled.


Here is the setting at Demo page:


Type in the menu name that you want to create at Menutype. After enable, you will see the menu has been created by click on Menu >>


This menu will be created base on your Section structure and Category you've had. If you have any changes in your section/category structure, please select Update Setting = Yes in JA Zin configuration page to make change to menu.

Note
: JA Zin used to generate the menu tree for selected section or category. So after you've running it and have your desired menu, you can turn it off to save your resource and get a faster load for your site. If you lease it on, menu will be re-generated everytime your page loading.


Now, go to yoursite_template_path/ja_vars_1.0x.php to set this menu to display.


III. TYPOGRAPHY

JA Teline ii came with a rich typography to give users more ability to customize content look and feel. Please check all JA Teline ii typography here at JA Teline ii Typography

IV. FREQUENTLY ASKED QUESTION

Q: I want to add a template position in to my Joomla!
A: Go to your Administration Panel, Site -> Template Manager -> Module Positions. Add your template positions and hit the Save button.

Q: Where can I change my footer?
A: If you want to change or remove something in the footer, just open the "ja_justicia/footer.php" then modify it to suite your needs.

Q: My images take a lot of white space and do not look good?
A: The {mosimage} may show some extra padding and margin. To solve this problem, go to your Joomla! Administrator -> Mambots -> Site Mambots and change the margin and padding parameters of MOS Image mambot to 0.
Q: Images without caption are stuck with text?
A: It is because Joomla! generates the code different when {mosimage} has and doesn't have its caption. So when you decide that the image will not having a caption, put it between the div tag like this
{mosimage}


Q: What's a module style? And module class suffix?
A: Almost modules offer you a parameter called Module Class Suffix. Set a value for this parameter and you will have your module's appearance differs from the others. JA templates often provide you some module styles which can be found in Module Styles area of the guide.