=== Facelift Image Replacment (FLIR) === Contributors: dzappone, cmawhorter Donate link: http://www.23systems.net/donate/ Tags: typography, text replacement, flir, titles, posts, images, themes, facelift, text, headings, fonts, formatting Requires at least: 2.8 Tested up to: 3.0 Stable tag: 0.8.9.2 Facelift Image Replacment is a script that generates image representations of text on your web page in fonts that visitors would not be able to see. == Description == FLIR for WordPress implements Facelift Image Replacement (FLIR) by Cory Mawhorter. It is in rapid development and at this time almost completely configurable from the admin panel. Several freeware fonts are provided with FLIR for WordPress. FLIR for WordPress is SEO friendly and only renders the image in the browser if JavaScript is enabled. You HTML/XHTML code remains unchanged leaving your head tags readable by search engines and the page readable by those without JavaScript. Facelift Image Replacement (or FLIR, pronounced fleer) is an image replacement script that dynamically generates image representations of text on your web page in fonts that otherwise might not be visible to your visitors. The generated image will be automatically inserted into your web page via Javascript and visible to all modern browsers. Any element with text can be replaced: from headers (`

`, `

`, etc.) to `` elements and everything in between! You can see examples of what it does here: http://facelift.mawhorter.net/examples/ = IMPORTANT NOTES: = If using a version prior to 0.7.0 please delete your existing version before installing this version = Before running autoupdate please empty your `facelift/cache` folder. This can be done from the plugin under FLIR for WordPress Utilities It will install and update but depending on your how long your scripts are allowed to run there is a possibility that the update will time out if you have a very large number of files in your cache. == Installation == = Requirements = = IMPORTANT: If using a version prior to 0.7.0 please delete your existing version before installing this version = PHP and GD. Little testing has been done with different versions of PHP. If you have PHP 5 with GD enabled you shouldn't have any problems. PHP 4 currently has some issues but should be resolved in the next release of Facelift. A newer version of ImageMagick (6.3.7+) is required for the FancyFonts and QuickEffects plugins. If GD is not installed on your server you will have to recompile PHP to include GD. If you are comfortable in WHM for cPanel, you can do that under the "Update Apache" tab (check the "GD" box). Check your settings carefully (especially the PHP version - cPanel may try to change it) before you hit build. Plesk and ISPConfig should have GD enabled by default. If you are not comfortable doing it yourself, ask your hosting company to do it for you. (Thanks Steve!) 1. Extract to your `wp-content/plugins` directory. 2. Look in `wp-content/plugins/facelift-image-replacement/facelift`. 3. Set the `wp-content/plugins/facelift-image-replacement/facelift/config-flir.php` to be writable (`chmod a+w config-flir.php`). 4. Set the `wp-content/plugins/facelift-image-replacement/facelift/cache` to be writable (`chmod a+w /cache`). 5. Add fonts of your choice to `wp-content/plugins/facelift-image-replacement/facelift/fonts` folder. 6 Make sure you have the `wp_footer()` call in the footer of your template See `/wp-content/theme/default/footer.php` for example. 7. Activate plugin in WordPress admin panel 8. Set FLIR configuration in the admin panel - `config-flir.php` must be writable for changes to take effect. 9. Customize tags for FLIR on FLIR submenu under the Design menu = Notes = * QuickEffect Plugin is not implemented yet * SuperCache Plugin is not implemented yet * If using a version older than 0.7 completely delete any old verions before upgrading * You cannot auto-upgrade from versions older 0.7.0 * Text remains intact in source so search engines see your page as text! == Screenshots == 1. Before Facelift Image Replacement 2. After Facelift Image Replacement == Changelog == = 0.8.9.5 = * Changed defualt cache behavior to reduce clutter in cache directory * By default cache cleanup was disabled now runs every 10 times * Cache keep time was set to 1 week, now set to every 6 hours * So by default every tenth time FLIR is invoked it will run cache cleanup and delete file older than 6 hours * This should reduce problems with cleaning the cache or disabling the plugin. * Changed initialization function for work with less overhead and the need to reload the page to reflect the changes. * Improved interface in admin panel. * Added better feedback for users in the form of meesage dialogs. * Added QuickEffects plugin option * Includes stroke, pattern fill, gradient fill, and drop shadow effects = 0.8.9.2 = * Removed console logging from flir.js, flirmin.js, flirlite.js, flirlitemin.js * Was causing errors in IE and unnecessary logging in Firefox. * Recompressed flirmin.js, flirlitemin.js using YUI and Packer for even smaller minification. = 0.8.9.1 = * Minor interface updates * Quick links in plugins list * Added additional support and FAQ links to admin panel * Readme and faq update = 0.8.9 = * Moved JavaScript calls to the footer to improve load times. * You must have the `wp_footer()` call in your template for FLIR to work - see `/wp-content/theme/default/footer.php` for example. * Updated Facelift to version 2.0b3. * Various improvments to rendering and speed * Using minified version of FLIR for improved load times * Additional features (not all are implement with FLIR for WordPress) * Bug fixes from previous versions * Added one additional setting - Single Cache Directory option * Updated admin panel to hide help text and provide icon to toggle = 0.8.8 = * Updated Facelift to version 1.2.2. * Corrects security vulnerability with Facelift = 0.8.7.1 = * Minor adjustments to work with WordPress 2.8. * Minor changes to jQuery method to ensure compatibility with jQuery 1.3.2. = 0.8.7 = * Fixed typo in JavaScript which creates issue with IE7. = 0.8.6 = * Fixed bug in disable for IE 6 that was also disabling for IE 7 (Thanks Zack for pointing out my stupid error) * Change some text in the admin panel to clarify a few items. = 0.8.5 = * Set the tags used by the Automatic method to follow the element types as defined in the configuration * Add checkbox to allow the use of external JavaScript libraries - jQuery, Scriptaculous and Prototype support only * Hide Elements to Replace section when using Automatic method as Elements to Replace is not used in that case. * Add checkbox to disable FLIR for IE6 or lower users to avoid rendering issues that sometimes occur. * Fix the global Use FancyFonts not showing it's activated. * Other minor interface fixes for WordPress 2.7 * Changed internal selection methods to increase speed and reduce memory usage. = 0.8.0 = * Updated Facelift to 1.2 release * Font Collections * Basic Callback Functions * Better error handling * Bug in generateURL causing HTML not to be sanitized * Added functionality/bug fixes for "wrap" mode. Better line-height support. * Rewrote element replacement algorithm. You no longer need to encapsulate plain text in span elements to have it replaced. The new algo is recursive so it can replace any number of child elements. You could even run it on document.body if you wanted to! * Added flir-image and flir-span classnames to the elements flir creates * Javascript Plugin support! * Moved DetectImageState code from facelift.js into a Javascript plugin * querySelectorAll support for the browsers that support it (Safari, FF3.1 alpha) * Font size modifier for cSize in FLIRStyle. You can now specify a font size calculation to be applied against the CSS font size. For example, if you want the generated image to have a font size that is 140% the one you specified in your CSS you could do cSize:'*1.4'. All font sizes will then be multipled by 1.4. * FLIRStyle.buildURL no longer requires an HTML object to be passed * Hover caching problems fixed. Better hover style support. * JPG and GIF support! Set the "output" option in FLIRStyle. The default output option is auto. Auto will cause the generated image to be a transparent png if the element doesn't have a background color set. Otherwise it will use GIF. * Hover now only works with elements. * Rewrote code for better readability and adherence to code conventions (hopefully) * Redesigned admin interface to be more logically organized (again, hopefully) * Added more helpful information to the configuration text. * Added ability to specify all elements to replace rather than just the few I had. * For example you can specify something like h1,h2,div#sidebar a to have your h1, h2 headers and all of the sidebar links replaced. * Fixed deactivation routine to preserve config-flir.php during auto upgrade. * If manually upgrading please deactivate plugin before upgrading to ensure config-flir.php is configured correctly. = 0.7.7 = * Updated Facelift to 1.2b3-3 = 0.7.6 = * Updated Facelift to 1.2b3-2 = 0.7.5 = * Added Facelift FancyFonts plugin option. FancyFonts uses ImageMagick to render fonts instaed of GD and can be useful * Fixed the errant semi-colon issue that everybody keeps telling me about but I kept not seeing for some reason * Added (hopefully) better text prompts to the admin panel = 0.7.0 = * Initialize plugin and set basic settings on install - note: the new version will overwrite your current `config-flir.php` * Set all `config-flir.php` settings (except allowed domain and font discovery which is done by the plugin) * Ability to flush cache on demand * Ability to reset the entire plugin and reinitialize * Ability to choose to have fonts automatically replaced for h1 to h5 headers or select a specific JavaScript library to use (jQuery, Prototype, Scriptaculous) * Latest version of Facelift 1.2b2 which fixes numerous rendering issues. * Admin panel page reloads after saving changes to reflect updates * Reduced number of fonts that come with plugin - all fonts are freeware/open source and redistributable * Easy addition of your own fonts - just drop in fonts folder and configure from admin panel * Selection of what fonts to include during element font selection * Moved additional admin includes into subdirectory * Minor cosmetic and coding fixes = 0.5.9 = * Fixed issue with not running correctly when WordPress is installed in a sub-directory (i.e. http://yousite.com/personal/blog/) = 0.5.5 = * Removed prototype implementation in favor of jQuery, noticeable improvement in speed. * Bug with IE in rendering header in some cases not jQuery related = 0.5.0 = * Added per element modes = 0.4.1 = * Updated Facelift to 1.2b = 0.4.0 = * Basic admin functionality added * Implemented prototype in plugin for per element rendering = 0.3.0 = * Initial Release * Auto rendering of `

` to `

` only * Using Facelift 1.1 == Frequently Asked Questions == = It doesn't work, how can I make it work? = * Please ensure that you have a cache directory at `wp-content/plugins/facelift-image-replacement/facelift/cache` and that it is writable. (`chmod a+w /cache`) * Please ensure that your config-flir.php file exists at `wp-content/plugins/facelift-image-replacement/facelift/config-flir.php` and that it is writable. (`chmod a+w config-flir.php`) * Make sure the `wp-content/plugins/facelift-image-replacement/facelift/` is readable * Check your theme's `footer.php` file and make sure it has the `wp_footer();` function in it. It should be located just above the `` element close tag. * Check your theme's `header.php` file and make sure it has the `wp_head();` function in it. It should be located just above the `` element close tag. * Check the FLIR admin panel under the design menu and make certain all the options are set in the FLIR Configuration section. Read the help text on the right of each option for information. * Check the FLIR admin panel under the design menu and make certain all the options you want are set in the Elements to Replace section. Heading 1 is generally used for the blog heading, Heading 2 is used for the posts on the main page and on individual post pages, Heading 3 is often used with posts on the catagories and tags pages. Small is often used for the date and author of the post. = When I set FLIR to wrap the text the text overlaps on a single line, how can I fix that? = FLIR 2.0b3 has a minor issue where the text will overlap if line-height isn't specified in your CSS file for that particular style. Adding line-height equal to the font size should correct that. For example `a.pagetitle{` ` font-weight:bold;` ` font-size:24px;` ` display:block;` `}` Can be updated like so to add line-height: `a.pagetitle{` ` font-weight:bold;` ` font-size:24px;` ` line-height:24px;` ` display:block;` `}` = Is FLIR be configurable from the admin panel? = FLIR is almost completely configurable from the admin panel. Eventually it is planned to be able to configure FLIR almost completely from the admin panel. At present to configure how and what fonts are used with flir and certain element to be replaced by FLIR. = Will the FLIR plugins be usable? = At present the FancyFonts plugin is implemented. QuickEffects will be implemented next. They require ImageMagick 6.3.7 or higher to function correctly and will be configurable from the admin panel. = What about the fonts that come with FLIR? = All the fonts that come with FLIR are either free or Open Source. = What advantages would you say FLIR provides over sIFR? Besides, of course, from needing flash? = * Facelift creates transparent PNGs which can lie over the top of any background you want. For example, take a look at Example #5. * It can easily create multi colored/font headers. (Example #3) * It can replace links and maintain their clickability (though I believe this functionality was added to sIFR). * It is very easy to implement. No other tools besides a web browser are needed and it is very easy to maintain. * It plays well with third party libraries such as jQuery and prototype. * You can take advantage of plugins such as the QuickEffects plugin and add things like drop shadows and pattern/gradient fills if you have ImageMagick installed on your server. = Is there some kind of caching system? If so, how does it work? = Facelift caches all images it generates to disk. It then will send appropriate headers to the browser if the image has not changed. This allows for drastic speed increases in rendering when browsing a website. After a couple of page views you sometimes won't even notice the text get replaced. By default, the cached images are saved indefinitely, but you can change facelift to run through the cache every so often and remove old images to save disk space. Just change the settings in the admin panel. You can further improve the speed of both FLIR and WordPress in general by using a PHP accelerator which is an extension designed to boost the performance of software applications written using the PHP programming language. An example of such and accelerator is Alternative PHP Cache (APC). For information on installing see http://www.23systems.net/2009/07/24/installing-alterative-php-cache-apc-with-plesk-on-ubuntu/ = It still doesn't work / I have other questions = * The best places to get answers are Facelift Image Replacement (FLIR) for WordPress @ 23Systems and/or FLIR Integration with WordPress. == Known Issues == * Default mode options are in the wrong location and needs to be moved. Should be in version 0.8.7 (Thanks Zack for reminding me of this) * Automatically updating the plugin may not work. This is most likely caused by the cache folder files being owned by www-data rather than the account holder for the web site. On deactivation the plugin now clears the cache folder and hopefully eliminates this issues. * Rendering in Konqueror is incorrect and displays all rendered text as the default size and black. == Upcoming Features == * Supercache option ~v0.9 * QuickEffects (requires ImageMagick) ~v0.9.5 * More... == Under consideration == * Uploading of fonts from within the plugin == Development Version == * Always the latest code * Please remove existing version before installing the development version