The hashtagger Plugin allows you to use #hashtags and @usernames in your posts where a #hashtag links to the corresponding tag archive page and a @username either links to the users profile page or to the users website. It also allows the usage of $cashtags to links to stock quotes.
This plugin uses the WordPress Tag system to field your post under the desired tags.
When saving a post each #hashtag is added as a “normal” tag – without leading hash – to the post. This makes hashtags fully compatible with existing tags. So there’s no need to change already existing posts created before using the hashtagger Plugin.
When showing a post all #hashtags are automatically converted to links leading to the corresponding tag archive page.
The usage of @usernames can be activated optionally.
@usernames can link either to the Users Profile Page or to the Users Website. If the username does not exist the text remains unchanged and no link is created. Optionally @nicknames can be used instead of @usernames. This is recommended for security reasons (read more).
The usage of $cashtags can be activated optionally.
A $cashtag can link to the concerning stock symbol at MarketWatch, Google Finance or Yahoo Finance.
Just type anywhere in a post…
This adds “hashtag” as tag to the current post and links to the tag archive page for “hashtag” when showing the post.
Use +#hashtag to only link to a tag archive page without adding “hashtag” as tag to the post. When showing the post the link is showed as “#hashtag” (without “+”). If the tag does not exist the text remains unchanged and no link is created.
Use duplicate ##hashes to tell the plugin that this word should not be converted into a tag. Duplicate hashes are replaced by a single hash when showing the post.
This creates a link either to the Profile Page or the Website of User “username” or optionally “nickname” (@username feature has to be activated – read more about usage of @nickname).
Use @@username to avoid link creation. When showing the post this is displayed as “@username” without link (@username feature has to be activated).
This creates a link to the concerning stock symbol at MarketWatch, Google Finance or Yahoo Finance ($cashtag feature has to be activated).
Use $$cashtag to avoid link creation. When showing the post this is displayed as “$cashtag” without link ($cashtag feature has to be activated).
The Plugins Settings can be found in
Settings -> #hashtagger. The settings are arranged in ten sections.
This is not a hashtagger settings but a WordPress setting that can be set in
Settings -> Permalinks. The default tag base is
tag. The current value is shown here for a complete overview. Read more about the usage of Permalinks in the WordPress Codex.
Activating this option allows you to use hashtags that start with a number. This also enables hashtags containing only numbers. Please note that all popular social media sites do not allow hashtags to start with numbers. Activating this feature allows you to use hashtags that would not be recognised as a hashtag anywhere else.
No link creation
This allows you to use hashtagger just to automatically generate tags from #hashtags without showing links to the corresponding tag archive page.
Here you can active the feature to process @usernames. There are four possible settings:
- Ignore @usernames
- Link @usernames to users profile page
- Link @usernames to users website in same browser tab
- Link @usernames to users website in new browser tab
Activate this feature to use @nicknames instead of @usernames. This is highliy recommended to enhance security! Although using @nicknames is the better option, the default is @usernames for compatibility to Plugin versions prior 2.1. Read more about this.
Here you can active the feature to process $cashtags. There are seven possible settings:
- Ignore $cashtags
- Link $cashtags to MarketWatch in same browser tab
- Link $cashtags to MarketWatch in new browser tab
- Link $cashtags to Google Finance in same browser tab
- Link $cashtags to Google Finance in new browser tab
- Link $cashtags to Yahoo Finance in same browser tab
- Link $cashtags to Yahoo Finance in new browser tab
Do not delete unused Tags
If you delete a #hashtag the tag is also automatically deleted from the Post. It is not possible to differentiate if a tag was added automatically by the hashtagger plugin or manually by the author (maybe the post was created before using the hashtagger plugin). Therefore all existing tags that are not found as a #hashtag inside the content are deleted on saving a post. If you want to preserve all tags or want to use additional tags please activate this feature.
Post Types section
Activate this feature to also process #hashtags (and optionally @usernames resp. @nicknames) on Pages. If you want to use #hashtags on your Pages please note that WordPress does not show the tags section for pages and also pages are not listed on tag archives. This plugin does not change this behavior of WordPress because there already exist several plugins that add the tag functionality for pages. Please use one of them if you want to tag your pages.
Custom Post Types
Activate this feature to also process #hashtags (and optionally @usernames resp. @nicknames) on Custom Post Types. Please note that it depends on the particular Custom Post Type if the tags section is shown in admin and if posts of that type are listed on tag archive pages.
Section Types section
Activate this feature to use #hashtags and optionally @usernames resp. @nicknames inside titles. Please note that when a title is used as link (as on blog index or on archive pages) there are links generated inside links. For a better user experience it is recommended to style the links generated by #hashtagger via CSS.
#hashtags (and optionally @usernames resp. @nicknames) always are processed inside the content. This is the minimum setting and can not be deactivated.
CSS Style section
CSS class name(s) for #hashtags
CSS class name(s) for +#hashtags links
CSS class name(s) [email protected]
This setting allows you to add CSS classes to generated links for @usernames resp. @nicknames.
Please note that the CSS classes must exist in one of the stylesheet files loaded by your Theme. You can add your custom CSS definitions by using one of the Custom CSS Plugins available in the WordPress Plugin Repository.
Remove symbols from links
Activating this option removes all symbols (#, @, $) from the links generated in front end.
Regeneration of all objects
This function allows you to regenerate all affected objects (Posts, Pages, Custom Posts) using the current settings. Please note that all existing tags that are not found as #hashtag will be deleted if you do not change the regarding setting!
The hashtag detection follows the rules for hashtags on Twitter, Facebook and Google+. The minimum length for a hashtag is 2 characters. A hashtag must not start with a number (this can be changed optionally). A hashtag not only ends at a space but also at punctuation marks and other special characters. A hashtag may contain underscores.
The plugin includes a function for usage in Themes.
do_hashtagger( $content )
This function processes
$content by using the current settings. This generates the links to tag archive pages and optionally author profile pages resp. users websites. This function does not add any tags to posts. You can use this function for example to process #hashtags used inside custom fields.
<?php echo do_hashtagger( get_post_meta( get_the_ID(), 'mycustomfield', true ) ); ?>