Note : mAutoPopup version 0.4.1 and previous releases are not fully functionnal with WordPress 2.5.

Installation

  1. Download the mAutoPopup package.
  2. Unzip this package.
  3. Using you favorite FTP client, upload all files to their target directory on your server.
    It should be : /your-wordpress-root/wp-content/plugins/
  4. Go to your Administration panel, in the Plugins section, and activate mAutoPopup.
  5. Go to your Settings > mAutoPopup page and click Setup mAutoPopup to configure mAutoPopup using the default options.
  6. You’re done !

Upgrading from any previous version

WordPress 2.5+ users should be able to automatically update the plugin directly from their Dashboard.

  1. Go to your Administration panel, in the Plugins section, and deactivate mAutoPopup.
  2. Replace all files by those of your installation package.
  3. Go to your Administration panel, in the Plugins section, and activate mAutoPopup.
  4. Go to the Settings section, in the mAutoPopup sub-menu, and click Upgrade mAutoPopup.
  5. You’re done !

Specific complementary upgrade instructions from version 0.4
(Not required from version 0.4.2)

  • Using your favorite FTP client, locate the directory where lay TinyMCE plugins.
    It should be : /your-wordpress-root/wp-includes/js/tinymce/plugins/
  • Remove the mautopopup directory if present.

Localization

Language packs are provided in the archive and are automatically set up to match your blog’s settings.

French is the only alternative language supported yet.
If you want to provide additionnal language packs, create a .po file using poEdit and the .pot template file provided in the archive. Send us the resulting file and we will add it in the archive.

System Recommendations

  • WordPress 2.x
  • PHP version 4.3.0 or higher
  • Javascript must be enabled on the target web browser to have mAutoPopup working.

Usage

Once activated, mAutoPopup works automatically for any post or page of you weblog. Insert a thumbnail from the Upload Manager of the post editor without any link to the file or the page and mAutoPopup will automatically detect it has a suitable thumbnail for magnification. A thumbnail surrounded by any link tag won’t be detected as suitable.

mAutoPopup works by default for all the pages or posts of you weblog.
However, its behavoir can be selected amongst four options :

  • Active for all posts and pages (default)
  • Active for all posts but those where the disabling quicktag is present
  • Disabled for all posts but those where the enabling quicktag is present
  • Disabled

As mentioned, you can define a specific behavoir for some posts by inserting quicktags.
The disabling quicktag is <!–mautopopup:disable–> and the enabling quicktag is <!–mautopopup:enable–>.
If the correct behavoir is selected, the presence of one of these quicktags anywhere in a post will alter it.
You can type it directly into the code editor or, better, use the Rich Text Editor plugin provided along with mAutoPopup from version 0.4.

Rich Text Editor (TinyMCE) plugin usage

mAutoPopup 0.4 includes a new rich text editor plugin to enable or disable mAutoPopup or to remove mAutoPopup quicktags from posts and pages.
Once installed, this plugin shows 3 buttons in the first toolbar of the rich text editor.

  • mAutoPopup enable button
    Adds the enabling quicktag to the current edited post or page. The quicktag is inserted at the cursor position.
    If a disabling quicktag already exists, this button removes it.
  • mAutoPopup disable button
    Adds the disabling quicktag to the current edited post or page. The quicktag is inserted at the cursor position.
    If an enabling quicktag already exists, this button removes it.
  • mAutoPopup remove button
    Removes any quicktag from the current edited post or page.

Known issues

Here is the known cases that may prevent mAutoPopup to work properly :

  • Thumbnails surrounded by link tags won’t be detected as magnifiable ones. Text can be also inserted between the link tags along with the thumbnail one.
    However, inserting other tags along will disturb mAutoPopup that will match the thumbnail as magnifiable.
  • The Rich Text Editor plugin may not be available for some WordPress 2.0 installations, though other functions of mAutoPopup work perfectly well.
  • Users have reported us that, in some occasions, thumbnails were not correctly detected, for instance when a fullscale image preceed them. This bug will be asserted in the next release if reproductible.

License

mAutoPopup, as WordPress, is released under the GNU GPL v2.
Permission to use, copy, modify, and distribute this software and its documentation under the terms of the GNU General Public License is hereby granted. No representations are made about the suitability of this software for any purpose. It is provided “as is” without express or implied warranty.