Using This Plugin

Adding a Gallery

Adding a new gallery is easy, Go to the gallery overview page and select "Add New Gallery".

Add the details of your gallery, and select the animation type, then click submit. Simple!

Adding a New Slide

It is simple to add a new slide, Go to the slide addition page and fill in the form making sure to select the Gallery and Slide Type then click submit

Gallery options explained

The following options are available when adding a new gallery:

Gallery Name: This is used for reference, However animation types may incorporate it into their design
Gallery Description (optional): A text area to allow you to keep track of what is inside the gallery. animation types may also incorporate this into their design
Animation Type: The type of animation you wish to use for this gallery, initially there are 3 on the system: fade, fade with bullets and a custom fade, but you can add your own later if required
Gallery Width :the width of the slides in the gallery in pixels, some animation types use it to keep all slides uniform in width

Slide Height:the height of the slides in the gallery in pixels, some animation types use it to keep all slides uniform in height

Slide options explained

The following options are available when adding a new slide:

Slide Name: This is used for reference, however with the WPTIS image type, it also becomes the alt attribute
Gallery: This is the gallery to add the slide to, you need to have added a gallery to add a slide
Slide Type: This is the type of slide, it is used to decode the content intered into a usable slide format, there are 2 default ones, HTML and Image, but you can add your own
Slide Link (optional): This is the link to apply to the slide if you want it to go somewhere!

Slide Show Time: Some animations allow you to set the length of time (in milliseconds) that the slide is shown on screen before transition begins
Slide Content: This is the most inportant field, it is used to add your content to the side, the HTML slide type accepts raw HTML where as the Image slide type only accepts the url to the image.

Add Your Own Animation To The Plugin

You can register your own animation type to the plugin by calling the WPTIS::public_register_animation function in the plugin with the following 4 parameters:

NAME: the name of the animation, its used in the dropdown and also to unregister the animation if required, try and keep it unique

PATH TO PHP FILE: the path to the PHP file that will output the gallery onto the page, it needs to be on the same site as the blog installation.

PATH TO CSS FILE (optional): the path to the CSS file that has the slide designs, it needs to be on the same site as the blog installation.

PATH TO JS FILE (optional): the path to the Javascript file that has the slide animation scripts, it needs to be on the same site as the blog installation.

The CSS and JS files are optional in case the CSS and JS are included in the PHP file

To remove your animation from the system, call the function WPTIS::public_unregister_animation with the name of the animation as a parameter. This can be used to remove any animation you no longer need on the system. The core animation types are automatically re-added on plugin activation

Add Your Own Slide Type To The Plugin

You can register your own slide types to the system as well, so where we have already added Image and HTML, you may wish add others, or your own formatting of the image/html types. To add your own type, simply call WPTIS::public_register_slide_type with the following parameters:

NAME: the name of the slide type, its used in the dropdown and also to unregister the slide type if required, try and keep it unique

PROCESSING FILE: This is the url to the file that processes the slide content into the final slide, the processing function must be called the same as the NAME but with any spaces changed to _’s

To remove your slide type from the system, call the function WPTIS::public_unregister_slide_type with the name of the slide type as a parameter. This can be used to remove any slide types you no longer need on the system. The core slide type types are automatically re-added on plugin activation

Adding your gallery to a post or page

To add your gallery to a post or page, simply use the shortcode: [ WPTIS_gallery id=XX ] where XX is the id of your gallery obtained from the plugin gallery view page.