// Internet Duct Tape

Tag Cloud Generator for WordPress.com is a computer program I created so that WordPress.com bloggers could have their own tag clouds like mine. There are some hidden settings under the hood for the more adventurous/advanced users.

These advanced settings are not supported.

I will warn you that I use the term tag and category interchangeably because they are the same thing on WordPress.

If you have suggestions for other tweaks to the program then leave a comment and I might implement it if I like the idea. The source code is available so you are always able to tweak it yourself.

Renaming or Excluding Categories

1. Run tagcloud.exe as you normally would.
   • The tagcloud.csv configuration file will be created.
2. Open the tagcloud.csv file with a text editor.
3. Change the value for a setting.
4. Save tagcloud.csv.
5. Re-run tagcloud.exe.

Example:

exclude; category to exclude from final list
exclude; sex
exclude; personal
rename; category to changed the name of; new category name
rename; engtechArticles; Articles
rename; engtechBlogging; Blogging
rename; engtechCommentary; Opinion
rename; engtechLinks; Links

The tagcloud.csv file can be used to specify categories that you want to rename and categories that you want to exclude from showing up in the tag cloud.

You *have* to match the category name exactly.

To Access the Hidden Settings

1. Run tagcloud.exe as you normally would.
   • The tagcloud.cfg configuration file will be created.
2. Open the tagcloud.cfg file with a text editor.
3. Change the value for a setting.
4. Save tagcloud.cfg.
5. Re-run tagcloud.exe.

Example:

---
password: *******
settings:
  bool_debug_mode: 0
  bool_display_count: 0
  bool_sort_alphabetically: 0
  bool_use_hierarchy: 0
  max_tags: 0
  min_tags_to_show: 1
url: http://engtech.wordpress.com
username: engtech

Sort Alphabetically

bool_sort_alphabetically=1 will force the tag cloud to be sorted alphabetically. This is the way version 070222 worked.
By default it is sorted by size.

Use Category Hierarchy

bool_use_hierarchy=0 will prevent child category post counts from contributing to their parents.

By default child category post counts are NOT added to the parent category.

Display Post Counts

bool_display_count=1 will display the number of posts in that category beside the tag.

By default post counts are not displayed.

Set the Max Number of Tags to Display

max_tags=NUMBER will control how many tags are displayed in total. Set this value to 15 to limit it to only the 15 biggest tags. Set this value to 0 to display all tags.

By default all tags are displayed.

Set the Minimum Number of Posts to Display

min_tags_to_show=NUMBER will control how many posts are needed in a category before it is displayed. Set this value to 5 to prevent any categories with less than 5 posts from displaying in the tag cloud.

By default tags with less than 1 posts are not displayed.

Debug Mode

bool_debug_mode=1 will create a tagcloud.dbg text file while the application runs. This file is useful for developing the program. Creating this debug file slows down program operation.

By default the debug file is not created.