“Fanciest Author Box” Documentation by “ThematoSoup” v1.2


“Fanciest Author Box”

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!


Table of Contents

  1. Introduction
  2. Installing Fanciest Author Box
  3. User Settings
  4. Automatically Adding Fanciest Author Box to Posts, Pages and Custom posts
  5. Color Settings
  6. Tabs Settings
  7. Using Custom Tab
  8. Using Fanciest Author Box Widget
  9. Adding Fanciest Author Box Using Shortcode
  10. Adding Fanciest Author Box Using Template Tag
  11. Displaying Only One Tab
  12. Uninstalling Fanciest Author Box
  13. Credits

Introduction - top

Fanciest Author Box is a WordPress plugin developed by ThematoSoup.

Fanciest Author Box WordPress Plugin Cover

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/


Installing Fanciest Author Box - top

There are two ways to install Fanciest Author Box:

1) Uploading .zip file from WordPress dashboard

2) Uploading plugin using an FTP client

http://docs.thematosoup.com/plugins/fanciest-author-box/installation/


User Settings - top

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).

User Settings - Fanciest Author Box WordPress Plugin

Display Fanciest Author Box

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

Twitter username. If a user leaves this empty, Twitter tab will not show in his/her Fanciest Author Box.

Facebook widget type

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

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+

Google+ ID. If a user leaves this empty, Google+ tab will not show in his/her Fanciest Author Box.

Position

Work position. Shown under name in Bio tab.

Company

Shown under name in Bio tab.

Company URL

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/


Automatically Adding Fanciest Author Box to Posts, Pages and Custom posts - top

Upon Fanciest Author Box activation, it will be automatically added below all posts, pages and custom posts.

Automatically Added Fanciest Author Box WordPress Plugin

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/


Color Settings - top

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 Settings - Fanciest Author Box WordPress Plugin

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.

Selecting a color using color picker

Clicking colored square next to an input field will display color picker.

Color Settings - Fanciest Author Box WordPress Plugin

After changing colors click Save Settings to update the fields.

Reseting default color settings

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/


Tabs Settings - top

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.

Tabs Settings - Fanciest Author Box WordPress Plugin

Display bio tab

Uncheck this to prevent showing bio tab.

Display Twitter tab

Uncheck this to prevent showing bio tab.

Show Twitter bio

Uncheck this to prevent showing Twitter bio in Fanciest Author Box Twitter tab.

Show latest tweet

Uncheck this to prevent showing latest tweet in Fanciest Author Box Twitter tab.

Show follower count

Uncheck this to prevent showing follower count in Twitter Follow Button in Fanciest Author Box Twitter tab.

Twitter cache interval

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.

Display Google+ tab

Uncheck this to prevent showing Google+ tab.

Display latest posts tab

Uncheck this to prevent showing latest posts tab.

Number of latest posts to show

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/


Using Custom Tab - top

Version 1.2 of Fanciest Author Box plugin introduces custom tab:

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:

Custom tab user settings

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:

Custom tab Pinterest

http://docs.thematosoup.com/plugins/fanciest-author-box/using-custom-tab/


Using Fanciest Author Box Widget - top

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:

How to add a widget using Fanciest Author Box WordPress Plugin

If you do not edit any of its settings, widget will:

You can override any of these in widget settings:

Fanciest Author Box Widget

Title

Widget title, defaults to "Author Spotlight" if empty.

Tabs settings

Only checked tabs will be displayed in Fanciest Author Box widget.

Select Author

Dropdown list of WordPress users. Determines which user to use for Fanciest Author Box.

Float photo

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.

Fanciest Author Box Widget with Float Photo

http://docs.thematosoup.com/plugins/fanciest-author-box/using-widget/


Adding Fanciest Author Box Using Shortcode - top

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.

Fanciest Author Box Shortcode

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:

Find User ID in WordPress

http://docs.thematosoup.com/plugins/fanciest-author-box/using-shortcode/


Adding Fanciest Author Box Using Template Tag - top

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/


Displaying Only One Tab - top

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:

Only one tab in Fanciest Author Box

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/


Uninstalling Fanciest Author Box - top

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:

Deactivate Fanciest Author Box

UAfter you have deactivated it, you can delete Fanciest Author Box by clicking Delete link under its name in plugins list:

Delete Fanciest Author Box Keep in mind that when you delete Fanciest Author Box you will also delete all of its settings as well as Fanciest Author Box user settings. If you only deactivate the plugin, its settings will remain and will not need to be entered again if plugin is re-activated.

http://docs.thematosoup.com/plugins/fanciest-author-box/uninstalling/


Credits - top

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.

Go To Table of Contents