Yada Wiki

Description

Yada Wiki provides a wiki post type, custom tags and categories, an index, and a table of contents option. The plugin allows you to link your wiki pages together using the wiki page titles.

There are two easy to use shortcode buttons available on the editor toolbar. Rather than try to remember the shortcodes and their values, it is recommended that you use these buttons to generate the shortcodes for you.

The “Add Wiki Link” Button:
When you click the first button, the add wiki link button, a pop-up opens where you enter the title of the wiki page you are linking to in the “Link” text box. You can optionally enter text into the “Show” text box that you want to show for the link, or leave that blank to just show the title.

When you click “OK”, a shortcode is inserted into your edit window at the cursor location. For example to link to a wiki page called “How To Make Iced Coffee” but show the text for the link as “How To Make My Favorite Drink”:

[yadawiki link=”How To Make Iced Coffee” show=”How To Make My Favorite Drink”]

You use Wiki Link shortcodes to create the structure of linked pages.

The “Add Wiki Listing” Button:
The Add Wiki Listing button gives you three options for adding some collected output.

Output TOC Page
The first option inserts a shortcode that will output your “TOC” page. With Yada Wiki, you can create a special wiki page with the title of “TOC” that will serve as the table of contents for your wiki. You can use wiki links and style the table of contents as you like in the post editor. Selecting this option allows you to embed the TOC page in another page. For example:

[yadawikitoc show_toc=”true”]

Output Wiki Category
The second option inserts a list of the wiki pages for one of your wiki categories. You can optionally choose to output the list by title or by creation date. For example:

[yadawikitoc show_toc=”true” category=”Drinks” order=”title”]

Output Index
The third option inserts an index of your wiki pages or categories. The output is in a responsive table-like grid and you can choose the number of columns. For example, to output wiki pages:

[yadawiki-index type=”pages” columns=”4″]

An example for listing all wiki categories by title:

[yadawiki-index type=”all-categories-name” columns=”3″]

Sidebar Widget:
There is also a Yada Wiki widget for showing the TOC page and a list of article titles for a given category in the sidebar. Please see the FAQ section for information about using the sidebar widget.

Documentation:
Documentation is available at https://www.webtng.com/yada-wiki-documentation/

The FAQs below also have good information.

Video Walk-through:
This video provides a walk-though of all of the features:

Acknowledgements

The user @JulianSMoore has been very helpful in suggesting improvements and reviewing changes.

Screenshots

These are the editor buttons for the Yada Wiki shortcodes.

Installation

You can install the Yada Wiki plugin either via the WordPress.org plugin directory or by uploading the files to your server. Once the plugin is installed, you can activate the plugin through the Plugins menu in WordPress.

FAQ

Installation Instructions

You can install the Yada Wiki plugin either via the WordPress.org plugin directory or by uploading the files to your server. Once the plugin is installed, you can activate the plugin through the Plugins menu in WordPress.

Why are some wiki links red?

When viewing wiki pages, if the wiki page exists it shows as a link. If it does not exist, and the user has permissions to edit posts, then the link shows up in red to indicate that the page needs to be created. You can click on the link to go to the page editor to create the new page. If the user does not have permissions, then they see the title in red, but no link is available.

Can I include external links and links to non-wiki pages in my wiki?

Yes, but the wiki shortcode is only for linking to wiki pages. If you want to link to external sites or regular posts or pages, then use the usual methods in the post editor to do so, but not the Yada Wiki shortcode.

Can I use the wiki shortcode in non-wiki posts and pages?

Yes, there is a Yada Wiki sub-menu under the main settings menu where you can enable showing the Yada Wiki shortcode buttons when editing posts and pages. Remember, the wiki shortcode is only for linking to wiki pages.

How can I add a wiki table of contents menu in the sidebar?

There is now a sidebar widget so that you can include the TOC or a category list of wiki articles. It is a multi-instance widget so you can have more than one version of the widget active at a time.

Does Yada Wiki work with Page Builder plugins?

Most page builders allow you to enter shortcodes and the Yada Wiki shortcodes should work. If the shortcodes do not work then let me know and I’ll take a look. The sidebar widget works well in regular widget areas, but may not work when embedded using page builders (except for Beaver Builder – see below).

The plugin has been tested and updated to work with Beaver Builder. By default Beaver Builder does not show 3rd party buttons in the Text Editor module, but you can enter the shortcodes manually. The sidebar widget works with the Beaver Builder widget module.

Can I nest shortcodes or include multiple TOC Category shortcodes on the same page?

You can include regular wiki link shortcodes in your TOC. You can also add multiple TOC Category shortcodes to a regular wiki page. Adding TOC shortcodes to the TOC page, or adding TOC Category shortcodes to the TOC page does not work.

Why don’t I see all of the categories when I output an index of categories?

Empty categories, with no wiki pages or child categories assigned, are excluded. Also, the index of a category or all categories only goes down to one level of child categories.

Why is there the option to sort the category index by slug?

Some people may have categories that are people’s names, such as book authors. The alternate ability to sort by slug gives some flexibility for custom sorting if, for example, you use the author’s last name for the slug.

How can I display the custom tags and categories?

You can use the tag cloud widget to display the wiki custom tags. There are also plugins in the WordPress repository that will allow you to display custom categories (or taxonomies).

How do I control comment options?

Yada Wiki does not support comments by default. There is a Yada Wiki sub-menu under the main settings menu where you can enable comment options and set defaults for new wiki pages.

After upgrading the plugin the wiki editor buttons are gone. How do I get them back?

The way the buttons are loaded was changed in version 2. If you do not see the buttons you may need to clear your browser cache.

Is the plugin compatible with WordPress multisite?

The plugin is not compatible with multisite.

Can I use custom permalinks?

The wiki links are based on links to wiki page titles, so it is expected that you will use the “Post name” type of permalink structure. You can change the URL slug for links from ‘wiki’ to another word of your choice on the Yada Wiki settings page.

How can I change the colors of the wiki links?

When rendered on the viewed page, wiki links are given a CSS class related to their post status (published, draft, etc). You can override the default colors in your style sheet. This is a convenience for those with edit permissions who might not realize that wiki articles have not been published. Note that WordPress permissions still control what posts can actually be viewed, this is just related to the display of wiki links. The classes are:

When viewing links for users with the “edit_posts” capacity:

.wikilink-new (post does not exist – a link to create it)

.wikilink-trash (post is in the trash – just text, no link)

.wikilink-pending (post has the status of “draft”, “auto-draft”, “pending”, or “future” – a regular link)

.wikilink-private (post has a status of “private” – a regular link)

.wikilink-published (the post is published – a regular link)

.wikilink-other (default if not one of the above. Applied to posts with a custom post status or to those with a status of “inherit” – a regular link)

When viewing links for users without the “edit posts” capacity:

.wikilink-no-edit (post does not yet exist or the post has the status of “trash”, “draft”, “auto-draft”, “pending”, or “future” – just text, no link)

.wikilink-published (the post is published – a regular link)

.wikilink-private (post has a status of “private” – a regular link)

.wikilink-other (default if not one of the above. Applied to posts with a custom post status or to those with a status of “inherit” – a regular link)

How can I style the TOC Output Wiki Category shortcode output?

The TOC Output Wiki Category shortcode outputs an unordered list.

The “ul” tag has a class of “wiki-cat-list”

The “li” tag has a class of “wiki-cat-item”

The link to the category in the “li” tag has the class of “wiki-cat-link”

Reviews

This plugin is perfect for what I want to do except that private pages don’t show up in the TOC, even when you are logged in and can otherwise navigate to them. Since 80% of my wiki pages need to be private, this won’t work for me.

This Wiki is near perfect! Doesn’t get in the way, no nags, no issues. Wiki pages show up under /wiki/ just as they should.

The only thing missing would be to replace the current listing at /wiki/ with a static page where other pages can be linked in. It also uses the default settings for publicize, so if you don’t want to tweet every page created you need to manually disable that per-page before posting.

While I’m hoping that these aspects will eventually be configurable, as it is right now it is still the best WP Wiki of the ones I’ve tried.

I use this plugin for my Dungeons and Dragons site to help me keep track of everything. I tried using a separate MediaWiki install, but I was frustrated with trying to integrate it into a cohesive site. Yadawiki lets me create the relational web I want to within the WordPress framework.