created: 20140910215514237
modified: 20140910215514237
tags: Concepts TableOfContents
title: Plugins
type: text/vnd.tiddlywiki

! Available Plugins

The following plugins are distributed on tiddlywiki.com as part of the main TiddlyWiki distribution.

<<list-links "[tag[Plugins]]">>

! What is a plugin?

A plugin in TiddlyWiki5 is a bundle of tiddlers packaged together as a single tiddler. Plugins are used to distribute optional, custom components for TiddlyWiki.

The tiddlers within a plugin appear as ShadowTiddlers.

Plugins can contain JavaScript modules, style sheets, and templates to extend the functionality of TiddlyWiki itself. Plugins can also be used to distribute ordinary text, images or other content. Plugins can be updated from their source as a unit.

See the PluginMechanism discussion for more details about how plugins are implemented internally.

! How to install a plugin

# Create a backup of your current TiddlyWiki HTML file ([[just in case|The First Rule of Using TiddlyWiki]])
# Open your TiddlyWiki in a browser
# In another browser window, find a link to the plugin, e.g. [[$:/plugins/tiddlywiki/example]]. You will typically find links to plugins on the home page of the plugin (for example, http://tiddlywiki.com/plugins/tiddlywiki/katex/)
# Drag the link [[$:/plugins/tiddlywiki/example]] to the browser window containing your TiddlyWiki
# Save your TiddlyWiki
# ''Refresh the window to automatically create the shadow tiddlers that are provided by the plugin in order for it to work correctly''
# The plugin should now be available for use

! How to uninstall / delete a plugin

# Create a backup of your current TiddlyWiki HTML file ([[just in case|The First Rule of Using TiddlyWiki]])
# Open the controlpanel and go to the plugin tab
# Click on the plugin you want to delete to open its tiddler
# Click the edit-mode icon then delete the tiddler
# Save your TiddlyWiki
# ''Refresh the window to automatically delete the shadow tiddlers created by the plugin''
# The plugin should now be deleted
