Manual:Extension/BlueSpiceCountThings

CountThings introduces a set of tags for counting various metadata in the wiki. Available tags are: countarticles, countusers, countfiles, and countcharacters.

What is CountThings?

Inserting tags

CountThings introduces a set of tags that allow for counting various metadata in the wiki. These information will be displayed on page in the configurable table.

Where do I find CountThings?

Insert magic word

Tags are added through the "InsertMagic" dialog by clicking on "Insert" in VisualEditor toolbar and then on "Magic word". In the resulting dialog, choose one of the four previously mentioned types of tags and click "Done".

choosing a tag

Configuring the countcharacters tag

You only see the function when you or another author integrated the special tag into an article. Everybody with writing permissions can use the tag, everyone with reading permissions can see the infobox as a result.

"Edit" and "Insert magic word or tag":

You can choose what you want count on your Page / Article:

countusers - shows number of users currently logged in the wiki.

countarticles - shows number of pages currently existing on the wiki.

countcharacters - shows information on the particular article. It can show different information depending on the mode:

• chars – number of characters on the page
• words – number of words on the page
• pages – number of pages this article would have if printed/exported
• all – default mode – shows all the information above.

For Example we will count characters:

You will get wiki code: "<bs:countcharacters>ARTICLENAME</bs:countcharacters>"

Instead ARTICLENAME you must type Name of your Article. 

In this case name of my Article is: TestPage.

So, wiki code will look like this: "<bs:countcharacters>TestPage</bs:countcharacters>"

Save and you should get:

Number of articles on the wiki

This number is based on the database table page. 

                <bs:countarticles />

            

Number of characters, words and pages (2000 characters = 1 Page) of an article

If you want to show all information (characters, words and pages) of an article, please use this code:

                <bs:countcharacters>ARTICLENAME</bs:countcharacters>

            

ARTICLENAME  is:  Name of your page.

If you just want to show part of the information, please choose between these different modes:

• chars: Only number of characters.
• words: Only number of words.
• pages: Only number of pages.
• all (Standard): All informations.

The mode is defined with "mode" Atribute:

                <bs:countcharacters mode="chars">Name of the article</bs:countcharacters><br>

            

Number of users in a system (users who are signed-in)

                <bs:countusers />

            

The code has to be integrated directly into the article.

See also

Our reference page.

While other tags have no configuration options, and just adding them to the page is sufficient, the countcharacters tag must be configured.

After inserting this tag or clicking on an existing tag already on the page, a dialog opens.

Count characters dialog box

Redlink page

Enter the name of the page for which to count characters. This name should include the namespace if the page is not in the main namespace. Next, select the mode from the dropdown menu.

While selecting the mode and page, a preview of the output is displayed above the dialog box. If the page title in the table heading shows the page name in red ("redlink"), you have misspelled the page name and the page does not exist.

Inserting tags in wikitext

If you add the tags in source code edit mode, use the following syntax.

                
<bs:countarticles />
<bs:countusers />
<bs:countfiles />
<bs:countcharacters mode="Words">ARTICLENAME</bs:countcharacters>

            

For the "countcharacters" tag, replace ARTICLENAME with the page name for which you want to get the count values. Also, "mode" can be adjusted as needed. For details, visit the reference page:

Related info

• Reference:BlueSpiceCountThings