Created: 6/15/2012
Updated: 7/4/2012
By: ThematoSoup
Email: contact@thematosoup.com
Thank you for purchasing Fanciest Author Box WordPress plugin. If you have any questions that are beyond the scope of this help file, please feel free to email us via our user page contact form. Thanks!
Fanciest Author Box is a WordPress plugin developed by ThematoSoup.
It can be used to add feature-rich author box to your WordPress site in several ways:
It blends into WordPress UI perfectly and uses WordPress Settings API to store its settings.
There are five tabs you can use in Fanciest Author Box:
Tabs Settings page in Fanciest Author Box settings allow you to select which tabs you'd like to show. Additionally, you can specify which tabs to show in widget settings or by using shortcode and template tag parameters.
User image used in all tabs is pulled from Gravatar, unless user Photo URL is specified in User Settings. If you'd like to upload a custom user image, you can upload it at Media > Add New screen and then copy its full URL into Photo URL field.
http://docs.thematosoup.com/plugins/fanciest-author-box/introduction/
There are two ways to install Fanciest Author Box:
http://docs.thematosoup.com/plugins/fanciest-author-box/installation/
NOTE: Fanciest Author Box will work just fine even if users don't supply any additional info. However, if a user doesn't enter Twitter, Facebook and Google+ details, Fanciest Author Box will only show two tabs - Bio and Latest posts.
Users can find their own Fanciest Author Box User Details section in Users > Your Profile.
Administrators can access Fanciest Author Box User Details for other authors in Users > All Users > Edit (Edit link appears when you mouseover a user).
Users can decide not to have Fanciest Author Box automatically added to their posts. They need to check "Do not automatically add Fanciest Author Box to your posts, pages and custom posts" option and it will not be shown.
Twitter username. If a user leaves this empty, Twitter tab will not show in his/her Fanciest Author Box.
Since version 1.1 it is possible to select from Subscribe and Like widgets. Subscribe is used for personal profiles, while Like can be used for Facebook pages, allowing users to promote their business, while keeping their personal profiles private.
Facebook username. If a user leaves this empty, Facebook tab will not show in his/her Fanciest Author Box. Additionally, to show Subscribe button in Fanciest Author Box, user must first allow subscribers in Facebook profile.
Google+ ID. If a user leaves this empty, Google+ tab will not show in his/her Fanciest Author Box.
Work position. Shown under name in Bio tab.
Shown under name in Bio tab.
Used to add link to Company. Shown in Bio tab. If this field is left empty, Company will be shown as plain text, instead of link.
http://docs.thematosoup.com/plugins/fanciest-author-box/user-settings/
Upon Fanciest Author Box activation, it will be automatically added below all posts, pages and custom posts.
These settings can be changed in Tools > Fanciest Author Box screen. For posts, pages and all registered custom post types, you can select whether you'd like to show Fanciest Author Box above, below, both above and below posts, pages and custom post types or not show it at all.
Each user can override this option for his/her posts in Fanciest Author Box User Settings.
Also, Fanciest Author Box can be disabled for individual tabs by using "ts_fab_hide" custom field. All you need to do is enter a value for that custom field and the author box will not be automatically added. Any value will do, as long as custom field exists and is not empty.
http://docs.thematosoup.com/plugins/fanciest-author-box/adding-to-posts/
Fanciest Author Box comes with a pre-defined color scheme. If you would like to change colors, you can do that from Tools > Fanciest Author Box screen in your dashboard. Under Display Settings you'll find Color Settings section:
Color fields are split into three sub-sections:
Each one of those has three color fields - background color, border color and text color. For each field you can either type color hex code into the input field or select a color using color picker.
Clicking colored square next to an input field will display color picker.
After changing colors click Save Settings to update the fields.
Clicking "Reset all color settings link" will revert all color options to default. After clicking the link you will not be able to revert to your custom settings! After resetting, click Save Settings button to update the fields.
http://docs.thematosoup.com/plugins/fanciest-author-box/color-settings/
You can find Fanciest Author Box Tabs Settings in Tools > Fanciest Author Box screen, under Tabs Settings tab. Tabs Settings can be used to set global options for Fanciest Author Box tabs.
Global options are also used as defaults (if nothing else is specified) in widget, shortcode and template tag.
Uncheck this to prevent showing bio tab.
Uncheck this to prevent showing bio tab.
Uncheck this to prevent showing Twitter bio in Fanciest Author Box Twitter tab.
Uncheck this to prevent showing latest tweet in Fanciest Author Box Twitter tab.
Uncheck this to prevent showing follower count in Twitter Follow Button in Fanciest Author Box Twitter tab.
Because of Twitter API limits (150 requests per hour) all data that is fetched using Twitter API is cached, each user getting one cache object. For example, if you have a 15 author website, you can allow 10 requests per hour, per author at most. In this case setting Twitter cache interval to 10 minutes makes sure that your website will not make more than 90 (15*60/10) requests per hour, preventing you from topping Twitter API limits.
Uncheck this to prevent showing Google+ tab.
Uncheck this to prevent showing latest posts tab.
This field allows you to specify number of latest posts to show in latest posts tab.
http://docs.thematosoup.com/plugins/fanciest-author-box/tabs-settings/
Version 1.2 of Fanciest Author Box plugin introduces custom tab:
This allows site administrators to toggle displaying of custom tab and set its title and content. It is also possible to allow individual users to override custom tab title/content in their user profiles:
Note that custom tab fields will not be shown in user profiles unless "Allow users to override custom tab in their user profiles" is checked in plugin settings page.
One of many possible applications for custom tabis showing Pinterest Follow button, code for which can be obtained at their Goodies page:
http://docs.thematosoup.com/plugins/fanciest-author-box/using-custom-tab/
Fanciest Author Box can also be added to your website as a widget. In order to use it this way, your theme must be "widget ready" and have at least one widgetized sidebar.
To add Fanciest Author Box widget, go to Appearance > Widget and drag widget to one of your sidebars:
If you do not edit any of its settings, widget will:
You can override any of these in widget settings:
Widget title, defaults to "Author Spotlight" if empty.
Only checked tabs will be displayed in Fanciest Author Box widget.
Dropdown list of WordPress users. Determines which user to use for Fanciest Author Box.
Useful for narrow sidebars. If unchecked, user photo will be displayed above all other data. If checked it will be floated on the left side.
http://docs.thematosoup.com/plugins/fanciest-author-box/using-widget/
If you're 100% unfamiliar with WordPress shortcodes, here's a brief explanation of how they work.
Fanciest Author Box shortcode can be used to add Fanciest Author Box to your posts, pages or custom posts from text editor in post editing screen. Adding one with default settings is as simple as:
[ts_fab]
Insert that into your post content and author box for author of the post you're adding it to will be displayed, showing tabs you defined in Tabs Settings.
However, using shortcode parameters you can specify both which author to use and which tabs to display. Here's what Fanciest Author Box with both parameters will look like:
[ts_fab authorid="10" tabs="bio,latest_posts,twitter"]
What this tells WordPress is to display author box for user whose user ID is 10 and show bio, latest posts and Twitter tab, in that order.
Here's full list of values for tabs parameter:
They need to be passed as comma separated string (see example above).
And this is how you can find a user's ID in WordPress:
http://docs.thematosoup.com/plugins/fanciest-author-box/using-shortcode/
NOTE: This information is only useful for WordPress theme developers. If you're not familiar with PHP code, you can still add Fanciest Author Box to your posts automatically, using a widget or using shortcode.
Fanciest Author Box can be added to your theme using ts_fab function:
<?php if( function_exists( 'ts_fab' ) ) ts_fab(); ?>
Function is wrapped in function_exists check to make sure your theme doesn't break when you deactivate Fanciest Author Box plugin.
Using this function will display Fanciest Author Box with its default settings - tabs you specified in Tabs Settings page and "best guess" author, for example, if you're adding template tag to a single post it will display Fanciest Author Box for that post author. However, for full control over what's being displayed, you can use following parameters:
ts_fab( $context, $authorid, $tabs )
What this tells WordPress is to display author box for user whose user ID is 10 and show bio, latest posts and Twitter tab, in that order.
http://docs.thematosoup.com/plugins/fanciest-author-box/using-template-tag/
With some outside the box thinking, you can also use Fanciest Author Box to display Twitter, Facebook or Google+ social widgets.
For example, if you'd like to add Google's Add to Circles widget to your post, you can do it by using shortcode:
[ts_fab tabs="googleplus"]
Specifying only one tab will prevent list of tabs from showing, resulting in this:
Using same logic, you can display Facebook Subscribe button, Twitter Follow button, your latest post or your bio anywhere you want.
Another way to do it is using template tag, also passing only one tab to $tabs parameter
http://docs.thematosoup.com/plugins/displaying-one-tab/
To uninstall Fanciest Author Box plugin you will first need to deactivate it. This can be done from Plugins screen in your WordPress dashboard. Click Deactivate link under Fanciest Author Box name in plugins list:
UAfter you have deactivated it, you can delete Fanciest Author Box by clicking Delete link under its name in plugins list:
http://docs.thematosoup.com/plugins/fanciest-author-box/uninstalling/
Icon Credits: design deck
Once again, thank you so much for purchasing Fanciest Author Box. We'd be glad to help you if you have any questions relating to this plugin. You might also consider visiting the forums and asking your question in the "Item Discussion" section.