BT MEDIA JOOMLA COMPONENT

(1)

BT MEDIA

JOOMLA COMPONENT

User guide

Version 1.0

(2)

www.bowthemes.com

Introduction

BT Media is full-featured multimedia component for Joomla. This extension connects easily with your YouTube, Vimeo, Flickr and Picasa account to get video and images files by some clicks. It's hard to resist its beautiful Fancy box style (currently use for Facebook) and its friendly User engagement system (ratings, comments, social media sharing). Let's display your digital gallery like a PRO!

Related Topics: Details View Demo Forum

Product Features

Media Management

 Flexibility: BT Media component allows you create multi level of Categories.

 Various media source: get images and videos from your computer folder and media

content hosting (Flickr, Picasa, YouTube and Vimeo).

 Smart Tag Manager: Automatically get tags while embedding YouTube and Vimeo files.  Uploading features: Supports upload by Flash and HTML 5.

 Useful supported extensions: add-media-to-article plug-in, Xmap, Smart Search...  Multiple image processing method.

Flexible Layout

 Multi-layout: Excellent interface with 03 layouts and various parameters to configure.

It’s easy to add or modify custom layout.

 Responsive Design: Support Full Responsive template

Voting and Commenting System

 Allows user for rating, commenting as well as social sharing..

Highly Optimization

 Powerful plug-ins: Search Plug-in is included. Article Plug-in allows users to insert

projects into articles is included

 Friendly interface: SEF and breadcrumbs are supported;

Cross-browser support

(5)

Installing and Upgrading

System Requirement

Server requirements PHP 5.0 or above with GD library is enabled. Please follow thislinkto check it

MySQL 5.0 or above Joomla 2.5.x or above;

Client requirements Firefox 3.5.x, Internet Explorer 7or above...

Downloading

BT Media Component is a commercial extension. Become our membership is required to download the product. Register here.

For Bowthemes member, please download the component at BT Media detail page.

You have 7 days to decide use the product or not. If the product can’t makes you satisfied in these days, your money will be refund. Click hereto send refund request.

Manual Installation

Please follow these steps to install the product: Step 1: Go to Extension Manager

(6)

www.bowthemes.com Illustrated image of successful installation:

Module Upgrading

(7)

Uninstalling

For uninstalling the product, please follow these steps: Step 1: Go to “Extension Manager”

Step 2: Click to “Manage” menu link

Step 3: Input component name in search textbox. Step 4: Mark checkbox of the module

(8)

Setting

Go to Joomla administration. Select “Components” from Main menu > BT Media to start. Hit “Option” button and you will be delivered to configuration area of BT Media component.

There are 4 main sessions:

 General option: Contains general configuration of the component

 Show options: Contains parameters that adjust the way one or multiple media items displayed on Joomla site.

 Image options: Contains parameters that adjust image processing before uploading image as well as before displaying them on the browser

(9)

General options

Field name Description Default value

Folder for saving files Set folder contains media item

uploaded from computer or gotten from other sources

images/bt_media

(10)

Enable voting On/Off voting system Yes

Allow guest votes Allows/ Disallows guest leave a vote No

Enable comment On /Off commenting system Yes

Enable sharing On/Off social share system Yes

Note: To turn on sharing and commenting system, BT Social Share plug-in must be installed

and activated

Show options

(11)

(12)

Theme Option

Select theme Choose Theme to display media

items on website

default

Media options

Display filter bar On/Off search bar and media filter

on website

Yes

Media item's displaying width Set width of media item while

displaying on fancybox

700

Media item's displaying

height

Set height of media item while displaying on fancybox

450

Display sub items Display/ Not display media items in

sub-category

No

Display title Display/ Not display media item’s

title

Yes

Display item description Display/ Not display media item’s

description

Yes

Display category Display/ Not display name of

category that contains media items

Yes

Display created by Display/ Not display media author ‘s

name

Yes

Show hits Display/ Not display number of

times media item loaded

Yes

Show tags Display/ Not display media item’s

tag

(13)

Limit item Set the number of items displayed in each page

20

Order by Set displaying order of media items Default - ordering

Type of order Select whether media items are

arranged by ascending or

descending order

ASC

Category options

Display category information Display/ Not display category ‘s

information

Yes

Display name Display/ Not display category’s

name

Yes

Display description Display/ Not display category’s

description

Yes

Display created by Display/ Not display category’s

information

No

Display hits Display/ Not display number of

times that category is displayed

No

Display parent Display/ Not display parent

category as an item on Joomla page

Yes

Expand child Display/ Not display child category

as an item on Joomla page

Yes

Order by Set the order following which

categories are displayed and

arranged

Default - ordering

(14)

www.bowthemes.com descending order

Image options

(15)

Flickr API Insert Flickr API key, you need it to

use api functions provided by Flickr. If you don’t have it yet, please go to

this pageto create one

Empty

Large image process Choose the way to treat with large

image

Crop

Thumbnail image process Choose the way to generate a

thumbnail image

Crop

Crop position Choose position of image to crop.

This parameter only appears when

you select “crop” as image

processing method

Center

JPEG Quality Set quality of JPEG image after

processing

100

Image width Set image width of large image 700

Image height Set image height of large image 450

Thumb width Set image width of thumbnail 200

Thumb height Set image height of thumbnail 130

Watermark System

Watermark system On/Off watermark features No

WM in categories Select categories on which

watermark will be applied

All

WM thumbnail Allows/Disallows watermark

applied on thumbnail

(16)

WM type Select watermark type: image or

text

image

WM text Add text string that will be used as

watermark

©bowthemes.com

WM image Image will be used as watermark Empty

WM font Select font for Watermark text Tahoma

WM font color Select font color for Watermark text FFFFFF (White)

WM font size Set font size for Watermark text 11

WM background On/Off Watermark Background Yes

WM background color Set color for Watermark

Background

000000 (Black)

WM Position Set position that applied watermark

on image

Bottom – Right

WM padding Set the distance between

watermark and nearest border of the image

4

WM Opacity Set watermark opacity 70

(17)

Fancy box options

Field name Description Default Value

Open effect Choose effect while opening fancy box None

Close effect Choose effect while closing fancy box None

Next/Previous item effect Choose effect while transiting to Next –

Previous item

None

Aspect Ratio Choose whether remaining aspect ratio

of image or not

(18)

Auto play Choose whether auto-starting

Slideshow while opening fancy box or not

No

Play speed Set speed of transition between items

(when “Auto-play” mode is set)

3

Padding Set Padding for fancy box’s content 15

Margin Set Margin for fancy box’s content 20

Close button Display/Not display close button of

fancy box

(19)

BT Media Administrator

Category Management

Follow this path: Main menu -> Components ->BT Media -> Categories.

Of if you are already in Bt Media component manager, you can choose category menu from menu list provided by BT Media Component.

 Add new category

(20)

www.bowthemes.com Fill in necessary information data fields

There are 3 tabs in this section

- Category: All information about category (requires full-information)

- Option: Select options to configure category displaying (You may don’t have to insert data. Information will be gotten from component configuration.

(21)

(22)

ID ID of category (will be

automatically added by system, you cannot add or change value of this field)

0

Name Insert Category name (this is

required field)

Empty

Alias Insert category Alias (If you add

nothing in this field, system will automatically create alias for the category in above fieldbased on its name

Empty

Parent Set parent category of this new

category. If this field set to “None”, added category will become source category

None

Created date Date adding this category. If you

leave it “Empty”, the system will automatically add current date and time on this field

Empty

Language Set language in which category is

allowed to display

All

Access Set access authority (which user

group can view this category)

Public

Status Set category status Published

(23)

Created by Add category author’s name Current user

Description Add category description Empty

 Option tab

Display category information Display/ Not display category

information

Use Global

Display name Display/ Not display category

name

Use Global

Display description Display/ Not display category

description

(24)

www.bowthemes.com author’s name

Display hits Display/ Not display category’s

number of displays

Use Global

Display parent Display/ Not display parent

Use Global

Expand child Display/ Not display child

Use Global

(25)

Meta title Title of category’s details page. Empty

Meta Keywords Value of HTML Keywords Meta

Tag. Each word is separated by a comma. Frequently used for SEO

Empty

Meta Description Enter a paragraph that will be

value of HTML Description Meta Tag. Used for SEO

Empty

Robots Choose value of HTML Robot Tag.

All of options are: - Use Global - Index, Follow - No Index, Follow - Index, No Follow No Index, No Follow Use Global

When all of these fields are filled, there are 3 options to complete “Add new category”

o Save: Save category information and go to edit page of this category o Save & Close: Save category then go to category manager page

o Save & New: Save category then reset all fields to default for creating new category

You can select “Cancel” to deny all above processes.  Edit Category

There are two ways to edit a category

(26)

www.bowthemes.com o Click directly onto category name

(27)

(28)

www.bowthemes.com  Delete category

Delete a category is a 2-step process o Send category to trash

Check category name that you want to delete then click “Trash” button

o Delete category

In category filter box, select “Trashed”, check category names that you want to delete then click “Empty trash” to delete selected categories.

Note: You can only delete empty category (don’t contains any media item). If a category

(29)

Media Management

Follow this path to Media Manager: Main menu -> Components ->Bt Media -> Media.

Or if you are already in BT Media component area, you can click Media menu from menu list provided by BT Media Component.

 Insert new Media

(30)

www.bowthemes.com o Add single media

In Media management page, click “New” button. You will be delivered to “Add-new media item” page

(31)

This section comes with 3 tabs:

- Media information: Media information (you may need to fill in completed information)

- Option: Select display options for category (You may not have to insert data as information will automatically be gotten from component configuration).

- Metadata: Metadata information

(32)

ID Media ID (will be automatically

added by system, you cannot add or change value of this field)

0

Name Insert Media item name (this is

required field)

Empty

Alias Insert media item Alias (If you add

nothing in this field, system will automatically create alias for the media item in above field, based on its name

Empty

Category Select category that contains

media item (this is required field)

Select Category

Language Set language in which media item

is allowed to display

All

group can view this item)

Public

Created date Date adding this media item Empty

Status Set media item status Published

Created by Add category author’s name Current user

Featured Choose whether this is featured

item or not

No

Tags Add a tag list for media item. Each

tag is separated by a comma (,)

Empty

Source of Media Set media source (forvideo item

gotten from YouTube or Vimeo)

(33)

Video URL Insert URL of gotten video (for video item gotten from YouTube or Vimeo). You can change when you need update this item to new video

Media value

Description Add media item description Empty

 Option tab

Display title Display/ Not display media item

name

Use Global

Display item description Display/ Not display media item

description

(34)

Display created by Display/ Not display media item

creator’s name

Use Global

Display hits Display/ Not display media

item’s number of displays

Use Global

Display category Display/ Not display name of

category that contains this item

Use Global

Show tags Display/ Not display tags of

media item

Use Global

(35)

Meta title Title of media’s details page. Empty

Empty

All of options are: - Use Global - Index, Follow - No Index, Follow - Index, No Follow No Index, No Follow Use Global

When all of these fields are filled, there are 2 options to complete “Add new media item”

- Save: Save media information and go to edit page of this item - Save & Close: Save media item then go to media manager page You can select “Cancel” to deny all above processes.

o Add multiple media item at the same time

(36)

At this page, you can add images or videos from various sources:

- Images: You can upload them from Computer folder or media folder of Joomla, as well as get them from Flickr or Picasa

 Upload from local

(37)

 Upload from Folder

 Click to select folders you want. If the folder is selected, you can click again to deselect

 Put a mark at the checkbox beside text strings ”get file from sub folder” if you want to get images from sub-folder of selected folder

(38)

www.bowthemes.com  Get from Flickr

Insert Flickr user name, wait for Ajax to load the albums. Select albums you want then wait again for Ajax to load album information. You can select getting images from X – to Y follow image order on albums, afterwards, click on “Get Images” button.

Note: You need to provide Flickr Api in BT Media Configuration.

 Get from Picasa

You can get images from Picasa in the same way you do with Flickr, but it doesn’t require API to start.

- Video

(39)

The process is similar to image uploading. The allowed file types are: FLV, MP4.

 Upload from folder

Again, the process is similar to image uploading

 Get file from YouTube

Select the way you get YouTube video: from account/playlist url (1) or from video url (2).

(1): You need to insert an existing YouTube account, let Ajax download video and playlist information so that you can get the videos

(2): you need to insert an available YouTube URL, let Ajax download needed information so that you can get the videos

 Get file from Vimeo

The process is similar to getting video from YouTube  Edit a media item

There are 2 ways to edit a media item

(40)

www.bowthemes.com o Click directly onto media item’s name

(41)

 Deletemedia item

Delete a category is a 2-step process o Send media item to trash

(42)

In item filter box, select “Trashed”, check item names that you want to delete then click “Empty trash” to delete selected items.

Tag Manager

Following this path:: Main menu -> Components -> BT media ->Tags.

(43)

 Add new tag

There are 2 ways to add tags: Add single tag in general way and add multiple tags in smart way when adding a media item.

o Add single tag

In Tag manager area, click “New” button. You will be delivered to “add-new tag area”.

Fill in necessary information data fields There are 2 tabs in this section

- Tag information: All information about tag (requires completed information) - Metadata: Metadata information

Let’s go to the detail:

(44)

ID ID of tag (will be automatically

(45)

or change value of this field)

Name Insert tag name (this is required

field)

Empty

Alias Insert tag Alias (If you add nothing

in this field, system will

automatically create alias for the category in above field based on its name

Empty

Created date Date adding this tag. If you leave it

“Empty”, the system will

automatically add current date and time on this field

Empty

Language Set language in which this tag is

allowed to display

All

group can view this tag)

Publish

Status Set tag status Published

Created by Add tag author’s name Current user

(46)

www.bowthemes.com  Metadata tab

Meta title Title of tag’s details page. Empty

Empty

All of options are: - Use Global

(47)

- Index, Follow - No Index, Follow - Index, No Follow No Index, No Follow

When all of these fields are filled, there are 3 options to complete “Add new tag” o Save: Save tag information and go to edit page of this tag

o Save & Close: Save tag then go to Tag manager page

o Save & New: Save tag then reset all fields to default for creating new tag You can select “Cancel” to deny all above processes.

o Add multiple tags at the same time or edit a media item

While adding a single media item, in Tag field, you can add one or multiple tag. Each tag will be separated by a comma (,). If this tag is already exist, the system will automatically add tag to media item. If not, the system will automatically create new tag then add tag to media item.

 Edit tag

(48)

www.bowthemes.com o Click directly onto category name

(49)

 Delete tag

Delete a tag is a 2-step process o Send tag to trash

(50)

www.bowthemes.com o Deletetag

(51)

BT Media Modules

BT Media Categories Module

This module allows you to display all categories or sub-categories of a category. You can adjust the display of all sub-categories or only sub-categories from selected categories, along with media items in each category.

- BT Media Categories configuration

(52)

www.bowthemes.com - Options of Module Configuration

Select category Sourced category that contains

displayed sub-categories

Root

Show sub category Display? Not display

sub-categories

Yes

Display item count Display/ Not display number of

media item in each category

No

BT Media Gallery Module

This module allows you to display, as gallery, some media items from categories set on Module configuration.

- BT Media Gallery module configuration

(53)

(54)

www.bowthemes.com - Options of Module Configuration

Select category Select category from which item

will be gotten and displayed

Select All

Display limit item Set number of media item gotten

to display on module

10

Items type Set media item type All

Items sort Set the order following which

media items aregotten, displayed and arranged

Ordering

Featured items Select whether only get featured

media items or not

(55)

BT Media Tags Module

This module allows you to display tags in a list with options - BT Media Tags Module configuration.

(56)

www.bowthemes.com - Options for Module Configuration

Number Tags Set the number of tag displayed 20

Sort By Select the way you want to

arrange tags

Ordering

Display item count Display/Not display number of

media item displayed in each tag

(57)

BT Media Plug-ins

BT Media Xmap Plug-in

This is plug-in that helps Xmap component to create and index contents of BT Media Component. You need Xmap component installed in order to run this plug-in.

BT Media Search Plug-in and BT Media Finder Plug-in

This is two plug-ins that help website to index contents of BT Media Component therefore allow user to search content of website inside BT Media Component.

BT Media Gallery Plug-in

This is a set of two plug-ins BT Media Button and BT Media Display.

- BT Media Button plug-in: provide a button that allows user to insert media item in article content (during editing process)

(58)

Common Error Using Product

Problem with Flash Uploader

At present, some web browsers don’t support Flash or they’re having problem with it, so you can’t upload images to Media’s gallery. Please use Simple Uploader instead. It’s just original File input of HTML.

Conflict with sh404 Component

If you are using sh404 for SEO on your site, your website may come across an error (Not Found 404 or Internal Server Error 500). In this case please open sh404 component, find

BT Media in By component tabs, then choose Use Joomla Route for the component like in

(59)

Uninstall by limitation of file size

Installation package of this component takes 2MB, not too large, but the problem here isthat some hosting services only allow customers to upload file with capacity less than 2MB. To solve it, you should contact with your hosting provider to increase upload max size.

You can see this information in Site > Site Information > PHP information tab

Problem with image processing

If you use BT Media in a long time, many images were created.In case that you try to change its size in control panel, thatmight cause the server to be overloaded because it can’t process all images at the same times. Thus, after setting a new dimension of the images, please save change and click “Rebuild Image” in “Medias Manager” to resize images one by one.

(60)

(61)

Contacting Bowthemes

All Bowthemes products include forum support, email support and ticket support. Please refer your membership package to select the compatible kind of support, as we may be able to solve the problem without delay.

Website: http://bowthemes.com

Forum support:http://bowthemes.com/forums/47-bt-media-gallery/

Email support: [email protected]

Ticket support: http://bowthemes.com/submit-a-ticket

If you encounter any issues with Bowthemes extensions and templates, email us at

[email protected] we will be happy to answer your questions.

BT MEDIA JOOMLA COMPONENT

BT MEDIA

JOOMLA COMPONENT

User guide

Version 1.0

Table of Contents

Introduction

Product Features

Installing and Upgrading

System Requirement

Downloading

Manual Installation

Module Upgrading

Uninstalling

Setting

General options

Show options

Image options

Fancy box options

BT Media Administrator

Category Management

Media Management

Tag Manager

BT Media Modules

BT Media Categories Module

BT Media Gallery Module

BT Media Tags Module

BT Media Plug-ins

BT Media Xmap Plug-in

BT Media Search Plug-in and BT Media Finder Plug-in

BT Media Gallery Plug-in

Common Error Using Product

Problem with Flash Uploader

Conflict with sh404 Component

Uninstall by limitation of file size

Problem with image processing

Contacting Bowthemes