This is a very simple plugin that shows a cloud of the most frequently used words in your wiki:

~~CLOUD~~
~~CLOUD:number~~

Optionally you can specify the number of words to display. Default is 50. Each of the words is linked to the search result page for it. The words are styled in a way that more frequent words are bigger and have a darker link color.

This plugin can also make a “tag cloud”. (tag plugin must be installed.) The syntax is:

~~TAGCLOUD~~
~~TAGCLOUD:number~~
~~TAGCLOUD:number>namespace1:subns11|.|namespace2~~

It also supports clouds for the most searched words in the wiki (searchstats plugin must be installed):

~~SEARCHCLOUD~~
~~SEARCHCLOUD:number~~

[showcount] the number of occurrences can also be output by adding the showCount option.

:number sets the number of items shown in the cloud. Default 50, minimal 1 and maximum 999.

>namespace1|namespace2 (tag cloud only) filters the tags in the tag cloud to these belonging to given namespace(s), with | you can add more namespaces.

All options together applied:

~~TAGCLOUD[showCount]:10>yournamespace~~

The plugin can be configured with the DokuWiki Configuration manager available in the admin menu.

You can exclude words from the word cloud by adding them to the word_blacklist configuration setting. Alternatively, words can be added each on its own line to inc/lang/<lang-code>/stopwords.txt or to conf/stopwords.txt. Remember that last line in file should be empty to work correctly. This affects also the fulltext indexing.

The CSS style of the cloud is defined in style.less. The less code makes it easier to modify the look of the cloud. In conf/userstyle.less you can just override the variables used.

To modify the text size in the cloud only the size factor @sF needs to be changed. The following example doubles the size by changing the size factor from 1 to 2.

To change the color modify one of the three base color values in @c0, @c1 or @c2. The following code will make the cloud have a lime green base color.

conf/userstyle.less

/* Size factor */
@sF: 2;
/* Lime green base color for the word cloud */
@c0: #32CD32;

Please only use RGB color values here, not CSS color names.

Most recent code changes:

• Merge pull request #91 from dokuwiki-translate/lang_update_839_170998… (2024-03-09 23:10)
• translation update (2024-03-09 13:50)
• Version upped (2023-06-12 23:50)
• Merge pull request #87 from dregad/cleanup (2023-06-12 19:30)
• Fix deprecated resolve_pageID() call (#82) (2023-02-11 17:23)
• Fix static analysis warnings (2023-02-11 15:33)
• Merge pull request #86 from dokuwiki-translate/lang_update_547_167457… (2023-01-24 19:29)
• translation update (2023-01-24 15:45)

Please report bugs and feature requests at the Bug Tracker.

The plugins page of dokuwiki.org presents a tag cloud that refers to all pages in the plugin name space.

Site using this plugin

• http://wiki.zebras-crossing.org (it is a TAGCLOUD modified with the CLOUD colors)

Hi, is it possible to cache the cloud? If i activate the plugin on my page, it slows down my system very much.

You can enable the caching feature by setting $renderer->info['cache'] = false; in syntax.php line 74 to true.

Note that with caching also ACL protected pages can be listed unintended. So be aware of how ACL are used before enabling caching.

Use underscores to specify whitespaces in tags.

You run cloud on a Windows server. The stylesheet style.css must be edited to hold Windows linebreaks rather then Unix. This solved the same problem for me. Ruud

The old discussion has been moved to discussion_old and will be cleaned up sooner or later. Please add bug reports and feature requests to the bug tracker of the plugin!

Related to the previous suggestion for tagcloud; If the first heading exists in a page of the specified tag, I'd like the tag-clouds to appear the first heading of the tag page.

I was trying to remove some tags from the tag cloud as I have nested tags as a structuring element but due to this, certain tags appear much more often than others (the 'folder' tags). However, the described methods (include stopwords.txt in conf/ or inc/lang/) apparently do not work for tag clouds. Is there some way to have the clouds behave the way I would like them to? — Cantello 2011/11/30 19:40

stopwords are only for the word cloud, not for the tag cloud. I consider adding a similar (but differently named) blacklist for the tag cloud. — Michael Hamann 2013/02/27 23:50

Using Dokuwiki release Adora belle with tag and cloud plugin:

Some of my tags and some of my page names equal. If such a tag appears in the tagcloud, the cloud item will link to the page with the equal name and not to the list of pages, that are tagged with the tag.

Julian 2013-02-16

This is intentional in order to give you the possibility to add a description for that tag on this page. You can use the topic syntax of the tag plugin in order to add the list of pages to the description of the tag. — Michael Hamann 2013/02/16 13:45

Thank you!

Manolito 2013-02-21

Can we force the tag's link in cloud to a page defined in advance in subnamespace ? By default, the link leads in a page autogenerated like “tag:tag1”. I would like to report “tag1” in address like “en:tag:ns1:ns2:tag1”. This is my way of organizing the navigation menu almost auto-generated which created this particular request… and with plugin multilingue it's better too. — Alinea 2013/03/09 12:17

It would be nice if you could also control what tag namespace to use as it is with page namespaces now.

For example, you tag some of your pages with topic1, topic2, myCategory:subTopic1, myCategory:subTopic2 and then you create a tagcloud restricting it to myCategory to get only subTopic1 and subTopic2 listed there.

— Seykela 2013/02/22 15:59

I agree with this, it would be a great feature!
— Fernando Ribeiro 2013/05/02 14:41

I would also like to see this functionality. It would be excellent if (just as in the SEARCHCLOUD syntax) a cloud could be generated from the resullts of a TagFilter plugin listing.— JD4x4