Powered by MediaWiki
Personal tools

Plugins/lightbox plugin

From B2evolution

Jump to: navigation, search

Contents

[edit] Lightbox

version 1.3

The Lightbox plugin allows you to create posts with links to pictures and display them using Lightbox or Lightbox2. You can view an post as an example of the lightbox plugin here.

[edit] Requirements

  • b2evolution >= 1.9

[edit] Download

Version 1.3: lightbox_plugin-1.3.zip

[edit] Participation

In general anyone can participate in making the Lightbox plugin better. You can participate in a number of ways.

You may also view the current SVN repository


[edit] Installation

  1. Copy the lightbox_plugin folder into the "plugins" folder of your b2evolution installation.
  2. Login to the administrative interface for your blog.
  3. Install the Lightbox plugin from the Settings::Plug-ins::Available plugins table using the [Install] link.

[edit] Usage

The lightbox plugin is a Renderer Plugin that will convert special text to html. However, it's recommended that you write html in your posts to ensure forward compatibility.

Usage is simple:

  1. Simply add links to your post with a rel attribute equal to 'lightbox'. Here's an example:
    <a href="your image url here" title="your image title here" alt="your alternative text here" rel="lightbox">Your link html</a>

    You can also add photos to a group using lightbox2.

    <a href="first image url here" title="your first image title here" alt="your alternative text here" rel="lightbox[groupname]">Your link html</a>
    <a href="second image url here" title="your second image title here" alt="your alternative text here" rel="lightbox[groupname]">Your link html</a>


    Note: The method of rendering the lightbox links with a render string will continue to be supported but is not recommended anymore because it may break the forward compatibility of your posts (should you, god forbid, change blog engines). This method may be easier to add lightbox links to posts but anyone wishing to maintain the forward compatibility of their posts should create a simple html like above.

    [lightbox IMAGE_URL [IMAGE TITLE]]LINK TEXT[/lightbox]

[edit] Customization

[edit] Lightbox

You can customize Lightbox in the same way you could normally by modifying the lightbox.css in the lightbox_plugin directory. Please visit the Lightbox homepage and read the section on Customizing.

[edit] Lightbox2

You can customize Lightbox2 by modifying the lightbox.css in the lightbox_plugin/css directory. Please visit the Lightbox2 homepage for more details.

[edit] License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

[edit] Warranty

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Copyright (C) 2007 Ian Lewis (IanLewis@member.fsf.org)