The custom word cloud plugin will generate word cloud images based on page
content or the contents of a form POST input named “content”. The cloud is
specified using shortcode tags on the page where the content or form exist.
As an example the following entered into a WordPress page will result in a
page with a word cloud image displayed above the paragraph that is a link
map with google searches for each word in the cloud:
[cwcloud] [cwcimage] [cwcmap] We the People of the United States, in Order to form a more perfect Union, establish Justice, insure domestic Tranquility, provide for the common defence, promote the general Welfare, and secure the Blessings of Liberty to ourselves and our Posterity, do ordain and establish this Constitution for the United States of America. [/cwcloud]
Another example where a user may enter their own paragraph of text and
generate a custom word cloud:
[cwcloud post="true" id="mycloud"] [cwcmap] [cwcimage] <form method="post"> <textarea cols="40" rows="10" name="content">[cwcpostcontent]</textarea> [cwcform] <input type="submit" value="Build Cloud" /> </form> [/cwcloud]
An example of a form with attributes set to some custom default settings and
the id attribute is not set so a fresh id will be generated for each user
created word cloud:
[cwcloud post="true" palette="#046, #fe0, #2f2, #82f" width="500" height="250" word_limit="30"] [cwcimage] [cwcdownloadlink] <form method="post"><textarea cols="40" rows="10" name="content">[cwcpostcontent]</textarea> <input type="submit" value="Build Cloud" /> [cwcform] </form> [/cwcloud]
The [cwcloud] tag accepts multiple attributes and there are some custom
shortcode tags that can be used inside the enclosed [cwcloud][/cwcloud] tags:
id – specify an id to use for this word cloud image
old_age – number of seconds before old images are removed from the cache (default old age is one week)
seconds_to_live – seconds before the cached image will be redrawn (default seconds to live is 5 seconds)
width – width of the cloud image
height – height of the cloud image
post – set to “true” if data will be posted from a form
palette – color palette in web hex codes, minimum of two colors, they can be 3 digit or 6 digit web type hex codes
i.e. #fff, #0ef582, #00f
angle – the angle to tilt each word, “random” or 0 to 360
double_angle – randomly flip words to the opposite angle
word_limit – maximum number of words in cloud
font_file – the ttf font file in the fonts directory to use
word_margin – margin around each word in cloud
exclude_words – words to exclude from counting
charlist – additional characters to accept within words, i.e. accent
[cwcloud] [/cwcloud] – must always be used as an enclosed short code
[cwcid] – the id of the cloud image, useful in forms
[cwcform] – provides cloud parameter form elements ready to use in a form
[cwcform_angle] – provides the angle form input element
[cwcform_double_angle] – provides the double_angle form checkbox
[cwcform_font_file] – provides the form font file select
[cwcform_width] – provides the form width input
[cwcform_height] – provides the form height input
[cwcform_word_margin] – provides the word margin input
[cwcform_palette] – provides the form input for the color palette
[cwcform_word_limit] – provides the form input for the word limit
[cwcform_exclude_words] – provides the form input for excluded words
[cwcpostcontent] – provides the posted content, useful for a form textarea
[cwcimage] – provides an tag pointing to the cloud image
[cwcmap] – provides a that maps the image to a google search
The cached images are stored in a subdirectory of the plugin’s directory named
Font files for the cloud are stored in a subdirectory of the plugin’s
directory named fonts.
Unzip the custom-word-plugin.zip file and copy the resulting custom-word-cloud directory to your
WordPress plugins directory.
Make sure the web server can write to the custom-word-cloud/cache/ directory.
And upload any TTF font files you want to use into the custom-word-cloud/fonts/ directory.
Activate the plugin and create a page with the appropriate shortcode tags.
- Why are some of the letters in some words are covering up other words and letters?
There is a long running bug in the PHP imagettfbbox() function that calculates
the coordinates of the box around a string drawn with a TTF font where the
letters that drop below the baseline, like the lower case letter p, fall
outside the bounding box. This has been fixed in recent versions of PHP but
for older versions you can create a larger word margin in the attributes to as
a temporary fix.
There are no reviews for this plugin.
Contributors & Developers
“Custom Word Cloud” is open source software. The following people have contributed to this plugin.Contributors
Translate “Custom Word Cloud” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
- Added stripping of slashes from $_POST[‘content’] if magic quotes is on.
- Fixed a bug where colors used exceeded the number in the palette and resulted in black words even though the color was not specified in the palette.
- Added the siteurl to image and link URLs so the plugin will work with mod_rewrite.
- Added an image map function that links words in the image to a google search
- Added the charlist attribute that will enable UTF8 accent characters