WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Eletro Widgets

Allows you to use the power and flexibility of the WordPress Widgets to set up a dynamic area anywhere in your site and manage multiple columns of wid

Usage

<?php new EletroWidgets([$cols = 2][, $id = 0] [, $onlyEletroWidgets = false]); ?>

The basics:

Go to the theme file where you want to put eletro-widgets and add the following code:

<?php if (class_exists('EletroWidgets')) new EletroWidgets(); ?>

This will create a two column container on your site where you will be able to add the widgets.

The first paramater it takes is the number of columns you want your container to have. So, if you want a 3 columns container, this is what you have to do:

<?php if (class_exists('EletroWidgets')) new EletroWidgets(3); ?>

After putting the code above in a template file, go to any of the pages that uses this template (logged with an user with administrative privileges) and you will be able to add or remove widgets from the Eletro Widgets area. You can add a WordPress default widget or you can create your own widget (see http://www.emanueleferonato.com/2008/02/15/how-to-create-a-wordpress-widget/).

ATTENTION: there are some default WordPress widgets that doesn't work with Eletro Widgets (we are working on this issue for future releases)

Customizing the appearance of the widgets

Eletro Widgets comes with a default css stylesheet that you can customize to fit your theme.

In order to do that, copy the file eletro-widgets.css to your theme's folder and edit it there as you like.

Advanced - multiple containers on the same page

Eletro Widgets allow you to have more than one container of widgets at the same page.

For example, you can have one line with 3 columns of widgets, and another set of 2 columns of widgets underneath.

In order to do that, all you have to do is declare a new instance of EletroWidgets passing the second parameter, wich is the unique ID for this container.

Example:

<?php if (class_exists('EletroWidgets')) new EletroWidgets(); ?>
<?php if (class_exists('EletroWidgets')) new EletroWidgets(3, 2); ?>

Note: There MUST be at least one container with the ID 0 (zero). All you have to do is declare at least one EletroWidget leaving the ID parameter empty

How to restrict available widgets

You may want to choose only a few widgets to be available on your eletro widget canvas.

You can do that by passing the third paramater as true. It will tell this canvas to hide from the list of available widgets all the widgets that were not defined as an "eletro-widget".

To define a widget as an "eletro-widget", do the following:

<?php defineAsEletroWidget($widgetId); ?>

Requires: 2.7 or higher
Compatible up to: 3.5.2
Last Updated: 2013-6-6
Downloads: 4,627

Ratings

5 stars
5 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

0,1,0
0,1,0
100,1,1
100,1,1
100,1,1
0,1,0 100,2,2
100,1,1
0,1,0