Documentation

Introduction

Thank you for purchasing the Easy Cufon Addon. If you have any questions that are beyond the scope of this help file, please feel free to contact me via my user page on the Concrete5 website (http://concrete5.org/marketplace/addons/easy-cufon/). I hope you enjoy using the addon!

Installing

This addon needs to upload .js (javascript) files. If this isn't allowed in your configuration of C5 this addon won't work at all.

Just follow the steps when this package is installed and you'll be fine!

Warning: The uploading of javascript file could be a security hazard! If users have the possibility to upload files, it could be that they will try to upload javascript files. These files could couse harm to your C5 website.After installing your custom font it's recomended that you delete "js" from the allowed file extensions. You can do this in the System & Settings -> Allowed File Types.

Adding new fonts

Step 1
Generate the requested font with the build-in generator. To begin you require a font file (.ttf .oft etc). Read the instructions from the generator carefully! If the font was generated you are able to download a Javascript file.

Step 2
This newly generated javascript file can be uploaded beneath the generator frame. After uploading your new font, you should see your font in the fonts list. The font list is ordered alphabetically.

Options and Configuration

In the Options-Tab there are a few options you can use to configure the addon.
They work as follows:

'Enable Cufon': This option will turn cufon on.

'Apply to Headers': This option will enable cufon on headers from h3 to H6.

'Fix FOUC' : The Fouc (Flash Of Unstyled Content) can occur using font replacement techniques, but also any Javascript heavy pages. This plugin uses a technique that hides the headers via Javascript until the cufon replacements are loaded. (the hiding must be done by Javascript to retain compatibility with non Javascript browsers). This removes the FOUC, and does so for all modern browsers.
Note: Due to the order of loading the javascript files required for Cufon it could happen that FOUC still occur.

'h3 Font Size' : Sets the default font size for h3 headers. Leave blank to not use. (px)

'H2 Font Size' : Sets the default font size for H2 headers. Leave blank to not use . (px)

'H3 Font Size' : Sets the default font size for H3 headers. Leave blank to not use. (px)

'H4 Font Size' : Sets the default font size for H4 headers. Leave blank to not use. (px)

'H5 Font Size' : Sets the default font size for H5 headers. Leave blank to not use. (px)

'H6 Font Size' : Sets the default font size for H6 headers. Leave blank to not use. (px)

'Header Letter Spacing' : Sets the spacing between letters for all headers. (px)

'Header Word Spacing' : Sets the spacing between words for all headers. (px)

Usage

Once a font is selected, Easy Cufon enabled and the above options have been set, Cufon will be applied automatically to all specified headers. You can apply the cufon replacement to further elements by adding any of the following class:

.easycufon

for example: <p class="easycufon">Lorem Ipsum</p>

First Line Helpdesk

My new font can't be uploaded
Make sure you generated the font from the build-in generator. The generated file should look something like this: 'My-Font-Name_400.font.js'.

I can't select my new font
Check in the file manager if the font is uploaded correctly. If this is the case, delete the font from the filemanager, delete the font from the Easy Cufon Addon and upload the generated file again.
Make sure you follow the right steps.

My font is selected, but it's not working
Check the settings in the options tab of this addon. Make sure cufon is enabled.

I see a fileset called "EasyCufon JS" in my filemanger
This package installs a fileset to manage the javascript font files. Do not delete this fileset unless you are unistalling the full package.

I have new files looking like "My-Font-Name_400.font.js" in my filemanger
This package preinstalls a few fonts. The font files are needed to generate your custom font on your C5 website. If you want to remove a font do this through this package, don't delete the font from the filemanager.

All other questions.....
Check http://concrete5.org/marketplace/addons/easy-cufon/ and click on support.

Uninstalling

When uninstalled this package it removes every .js font file. The only thing left is the fileset "EasyCufon JS". This can be deleted manually.