Archive for ‘WordPress Banner Rotator Plugin’

Banners Config: Periodic Ajax Refresh

« Configuration

Banners > Configuration >Periodic Ajax Refresh

Auto Refresh Ads

The default is set to “No”. This automatically refresh banner ads using Ajax technology and should be turned off when using code ads.

Fade Banners

With ‘Auto Refresh Ads’ turned on by setting it to Yes, this option becomes available. Turn this setting on to have a fading effect for banners and turn it off for no effect.

Refresh Interval

At what interval (measured in seconds) should banner ads automatically refresh via Ajax?

E010FV0000

Banners Config: Ads Order

« Configuration

Banners > Configuration > Ads Order

Zone Ads Order

This default is “Random”  This may be changed to “In Order”. This setting affects  how the banner ads should be ordered in zones when they are displayed. Please note that it only applies to Zones widgets, embedded and hardcoded at the moment.

Banners Config: Text Box Presentation

« Configuration

Banners > Configuration > Text Box Representation

This section allows you to customize the style of your WordPress Banners plugin text box(es).  A sample text box preview is provided in the Dashboard and its style will be updated as you change the values below. When you are happy with the style you have defined save the configuration.

Background Color

This defines the background text box Values may be type in in RGB  format e.g. “rgb(255, 228, 240)” or  hexadecimal notation “#FFE4F0″

Border

This sets the thickness of the border of the Banner text box. Values typed pixels, color, line style e.g. “1px #999999 solid” or “2px #FF0000 dotted”

Text Color

This sets the text color Banner text box. e.g.. “#336699″

Padding

This sets the padding of Banner text box. Padding is distance set between the Banner Ad and the surrounding content. Values are set in pixels e.g. “4px” or “3px 0px 3px 4px”

Banners v2.6 Release Notes

WordPress Banner Rotator plugin v2.6 release notes.

  • Added
    Multiple ads per widget. It is recommended that you set ads to random order for zones when using zones widgets to prevent duplicate ads from showing up in a single widget.
  • Added
    Ordering/sorting of banner ads per zone with a click and drag interface.
  • Improved
    Sorting options of records in all admin sections.
  • Added
    ‘Show All’ link in all admin sections to show all records when needed and prevent paging.
  • Added
    Show ‘Expired’ for an ad record in the ‘Adverts’ section if an ad has expired.
  • Compatibility
    The ability to turn On/Off jQuery library loading in the ‘Configuration’ section of the plugin. If jQuery is already manually loaded or loaded by another plugin, it is recommended that you set this setting to Off.

  • Improved
    Meta boxes in ‘Configuration’ section to be sortable by dragging and expandable/collapsible by clicking on the title. Layout is saved for the next time you return to the ‘Configuration’ section.
  • Fixed
    A bug with the ‘Reset Clicks’ bulk action in the ‘Adverts’ admin section.
  • Added
    “languages” folder for language files in the plugin folder. All new translations should be placed into this “languages” folder where the language file should be named “wp-banners-xx_XX.mo” and xx_XX should be replaced by your locale like nl_NL, de_DE, es_ES, en_UK, etc…
  • Removed
    The ‘Support & Help’ section has been removed from the plugin menu.
  • Fixed
    Expiration date input calendar for ads when specifying an expiry date.
  • Added
    Row actions in all admin sections when records are hovered with the mouse, links are displayed below the title as actions which can be performed on the record such as Edit, View, Delete, Preview, etc…
  • Changed
    WordPress 2.9.2 style ‘Add New’ buttons in all admin sections.

  • Removed
    CSS overflow:hidden; has been removed from the DIV with class “wpbrbanner” for layout reasons.
  • Changed
    New plugin icon
  • Fixed
    A JavaScript error in the ‘Appearance’ > ‘Widgets’ section of WordPress caused by the Banners plugin.
  • Improved
    Performance of the plugin by removing the transient_update_plugins hook which checks for a new version. New version checking will only be executed on the ‘Plugins’ page of the WordPress dashboard.

  • Added
    User access level settings for all sections.

Banners: Translation

« Usage

You can easily translate the entire WordPress Banners plugin with all its words and phrases into your own preferred language.

Open poEdit

Before you can get started, you’ll need to open the poEdit application on your computer. If you don’t have poEdit, you can download and install it for your platform.

Open/Create Catalog File

The WordPress Banners plugin is distributed with a default, English catalog file named ‘wp-banners-en_US.po’ inside ‘wp-banners’. You may open this file with poEdit and save a copy so that you can start translating immediately. If you open the existing catalog file, all the strings will be available for translation immediately.

Alternatively, you can create a new catalog file though by choosing ‘File’ > ‘New Catalog…’ inside the poEdit application.

click to enlarge

Fill in the project information such as the plugin name, your team name, your preferred language, your country, charset, etc. These values under the ‘Project Info’ tab can be anything you wish them to be.

click to enlarge

Under the ‘Paths’ tab, you’ll need to fill in “../” as the base path and under the paths, you’ll need to create a new path and also fill in “../”. This indicates that the PHP files are in the upper/parent directory (one directory up) of the one the language file will be located in.

Create 2 keywords under the ‘Keywords’ tab. The one is 2 underscores “__” and the other one is underscore and the letter ‘e’ which makes “_e”. These will always remain the same since they are inside the code.

click to enlarge

With that done, click the ‘Ok’ button so that poEdit can allow you to save the catalog file. Save the file with the filename ‘wp-banners-xx_XX.po’ where the “xx_XX” part should be replaced with your language code, followed by an underscore and then your country/region code, such as en_US (US English), en_UK (UK English), nl_NL (Dutch), zh_TW (Traditional Chinese for Taiwan), es_ES (Spanish), se_SE (Swedish), etc. Save it inside the ‘wp-checkout/languages’ directory/folder of the plugin. You will notice that it immediately saves a .MO file (which is the actual language file) as well. The .PO file is just the catalog file and it is not used by the plugin through WordPress. Be sure to keep the .PO catalog file for future changes though.

Once you save the catalog file, poEdit will start scanning the PHP files recursively in the upper/parent directory (the ‘wp-checkout’ folder) for words/phrases encapsulated by __() or _e() so that they can be translated.

click to enlarge

Translate Words/Phrases

Whether you chose to open the existing catalog file or create a new one in Step 2, the words and phrases inside the WordPress Banners plugin should now be in front of you, ready to be translated. You’ll need to type the translated string (in your language) in the box below the box which shows the English string.

click to enlarge

Set your WPLANG locale

Open up your WordPress configuration file named ‘wp-config.php’ and fill in your locale as the value for the WPLANG defined constant. The locale will be your language code, followed by an underscore “_” and then your country/region code such as en_US (US English), en_UK (UK English), de_DE (German in Germany), nl_NL (Dutch in the Netherlands), zh_TW (Traditional Chinese for Taiwan), es_ES (Spanish), se_SE (Swedish), etc. Be sure that you saved your catalog file (.PO) and your language file (.MO) as ‘wp-banners-xx_XX’ inside ‘wp-banners’ where the “xx_XX” part in the filename should be replaced by your locale which you also define here in the configuration file.