This shortcode allows you to display an author box anywhere you want.
It can be used anywhere within WordPress where shortcodes are supported. For most users, this will primarily be within the content of a WordPress post or page.
A shortcode is just one method used to display a Molongui Author Box in WordPress. Author boxes can also be automatically displayed on posts and pages via plugin settings configuration. See Display Settings to read more detailed information on that option.
By default, an author box being displayed by this shortcode is always shown, regardless of Display Settings configuration. If you want the Display Settings to control whether the author box should be displayed, you can use the ‘force_display=no’ attribute.
Example
The trivial shortcode would be:
Editor input
[molongui_author_box]
The shortcode will display the author box in different ways, depending on how you use the optional attributes to customize the author box layout.
That trivial shortcode will display an author box showing the information of the author of the page where the shortcode is inserted on. And the styling used to decorate the box will be taken from the Styling Settings configured at the Customizer.
If you want to see some examples of how you can make your author boxes look like, check this document.
Attributes
To customize which author information to show or how the displayed author box will look like, you can use the shortcode with additional attributes. All styling settings can be overridden.
By default, current page’s author information is displayed and styling settings are taken from the ones configured at the Customizer.
Check out below all the available attributes you can use to fully customize the author box:
force_displayoptional
Whether the author box should be displayed regardless of any display setting.
Accepts “yes” or “no”.
Defaults to yes.
Available since version 3.2.4.
Replaced by no.
idoptional
The ID of the author to display.
Accepts integer as post ID.
Defaults to current post author ID.
Available since version 1.0.0.
typeoptional
The type of author to display.
Accepts “user” or “guest”.
Defaults to user.
Available since version 1.0.0.
layoutoptional
The layout to be used to render the author box.
Accepts “slim”, “tabbed” or “stacked”.
Defaults to config.
Available since version 1.0.0.
profile_layoutoptional
The template to be used to display the author profile information (name, bio, picture…).
Accepts “layout-1”, “layout-2”, “layout-3”, “layout-4”, “layout-5”, “layout-6”, “layout-7” or “layout-8”.
Defaults to config.
Available since version 1.0.0.
related_layoutoptional
The template to be used to display the author related entries.
Accepts “layout-1”, “layout-2” or “layout-3”.
Defaults to config.
Available since version 1.0.0.
box_widthoptional
Amount of space (in %) the author box can take.
Accepts “10”, “20”, “30”, “40”, “50”, “60”, “70”, “80”, “90” or “100”.
Defaults to config.
Available since version 1.0.0.
box_marginoptional
Space (in px) to add above and below the author box.
Accepts “0”, “10”, “20”, “30”, “40”, “50”, “60” or “80”.
Defaults to config.
Available since version 1.0.0.
box_borderoptional
Box border side(s) to display.
Defaults to config.
Available since version 1.0.0.
box_border_styleoptional
Box border style.
Accepts “solid”, “double”, “dotted” or “dashed”.
Defaults to config.
Available since version 1.0.0.
box_border_widthoptional
Box border width.
Accepts 1 to 10.
Defaults to config.
Available since version 1.0.0.
box_border_coloroptional
Box border color.
Accepts CSS color values.
Defaults to config.
Available since version 1.0.0.
box_backgroundoptional
Box background color.
Accepts CSS color values.
Defaults to config.
Available since version 1.0.0.
box_shadowoptional
Whether and where to add a shadow to the author box.
Accepts “none”, “left” or “right”.
Defaults to config.
Available since version 1.0.0.
show_headlineoptional
Whether to show a headline above the author box.
Accepts “yes” or “no”.
Defaults to config.
Available since version 1.0.0.
headlineoptional
The string used as the author box headline.
Accepts plain text.
Defaults to config.
Available since version 1.0.0.
headline_text_sizerenamedoptional
Font size used to display the headline.
Accepts a size from 8 to 100.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
headline_text_stylerenamedoptional
Font style used to display the headline.
Accepts “normal”, “bold”, “italic”, “underline”, “overline” or “overunderline”.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
headline_text_caserenamedoptional
Headline text case.
Accepts “none”, “capitalize”, “uppercase” or “lowercase”.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
headline_text_alignrenamedoptional
Headline text align.
Accepts “left”, “center”, “right” or “justify”.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
headline_text_colorrenamedoptional
Headline text color.
Accepts CSS color values.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
show_avataroptional
Whether to display the author profile image.
Accepts “yes” or “no”.
Defaults to config.
Available since version 1.0.0.
avatar_stylerenamedoptional
Whether and how to shape the author profile image.
Accepts “none”, “rounded”, “circled”.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
avatar_border_widthrenamedoptional
Width of the border to add to the author profile image.
Accepts a number from 1 to 10.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
avatar_border_stylerenamedoptional
Author image border style.
Accepts “solid”, “double”, “dotted” or “dashed”.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
avatar_border_colorrenamedoptional
Avatar border color.
Accepts CSS color values.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
avatar_default_imgrenamedoptional
Default image to show if none uploaded and no gravatar configured.
Accepts “blank”, “mm” (Mistery Man) or “acronym”.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
acronym_text_coloroptional
The color used to display the author name acronym.
Accepts CSS color values.
Defaults to config.
Available since version 1.0.0.
acronym_bg_coloroptional
The color used to fill the author name acronym background.
Accepts CSS color values.
Defaults to config.
Available since version 1.0.0.
name_text_sizerenamedoptional
Font size used to display the author name.
Accepts a number from 8 to 100.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
name_text_colorrenamedoptional
Color used to display the author name.
Accepts CSS color values.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
name_text_alignoptional
Author name text align
Accepts “left”, “center”, “right” or “justify”.
Defaults to config.
Available since version 1.0.0.
name_inherited_underlinerenamedoptional
Whether to keep theme’s underlining the author name.
Accepts “keep” or “remove”.
Defaults to config.
Available since version 1.0.0.
Replaced by yes.
name_link_to_archiveoptional
Whether to make the author name link to the author archive page.
Accepts “yes” or “no”.
Defaults to config.
Available since version 1.0.0.
show_metaoptional
Whether to show author metadata (job position, company…).
Accepts “yes” or “no”.
Defaults to config.
Available since version 1.0.0.
meta_sizeoptional
Font size used to display the author metadata (job position, company…).
Accepts “biggest”, “bigger”, “big”, “normal”, “small”, “smaller” or “smallest”.
Defaults to config.
Available since version 1.0.0.
meta_coloroptional
Color used to display the author metadata (job position, company…).
Accepts CSS color values.
Available since version 1.0.0.
show_biooptional
Whether to show the author bio description.
Accepts “yes”, “no”.
Defaults to yes.
Available since version 1.6.4.
bio_lengthoptional
Whether to display the full or short bio description.
Accepts “full”, “short”.
Defaults to full.
Available since version 1.6.4.
bio_sizeoptional
Font size used to display the author bio.
Accepts “biggest”, “bigger”, “big”, “normal”, “small”, “smaller” or “smallest”.
Defaults to config.
Available since version 1.0.0.
bio_coloroptional
Color used to display the author bio.
Accepts CSS color values.
Available since version 1.0.0.
bio_alignoptional
Text alignment to display the author bio.
Accepts “left”, “justify”, “center” or “right”.
Defaults to config.
Available since version 1.0.0.
bio_styleoptional
Text style to display the author bio.
Accepts “normal”, “bold”, “italics” or “itbo” (italics-bold).
Defaults to config.
Available since version 1.0.0.
show_iconsoptional
Whether to show the social media icons.
Accepts “yes” or “no”.
Defaults to config.
Available since version 1.0.0.
icons_sizeoptional
The size of the social media icons.
Accepts “biggest”, “bigger”, “big”, “normal”, “small”, “smaller” or “smallest”.
Defaults to config.
Available since version 1.0.0.
icons_coloroptional
Color used to display the social media icons.
Accepts CSS color values.
Available since version 1.0.0.
icons_styleoptional
The styling used to display the social media icons.
Accepts “default”, “squared”, “circled”, “boxed”, “branded”, “branded-squared”, “branded-squared-reverse”, “branded-circled”, “branded-circled-reverse” or “branded-boxed”.
Defaults to config.
Available since version 1.0.0.
bottom_bgoptional
The color used to fill the background of the bottom section on a “ribbon” layout.
Accepts CSS color values.
Available since version 1.0.0.
bottom_borderoptional
Width of the border to add at the top of bottom section on a”ribbon” layout.
Accepts “none”, “thin” or “thick”.
Defaults to config.
Available since version 1.0.0.
bottom_border_coloroptional
The color of the border to add at the top of bottom section on a”ribbon” layout.
Accepts CSS color values.
Available since version 1.0.0.
hide_if_no_biooptional
Whether to hide the author box if there is not biographical information to show.
Accepts “yes” or “no”.
Defaults to config.
Available since version 1.2.14.
show_relatedoptional
Whether to show “related posts” link on the author box.
Accepts “yes” or “no”.
Defaults to config.
Available since version 1.0.0.
related_order_byoptional
The criteria to sort related posts.
Accepts “title”, “date”, “modified”, “comment_count” or “random”.
Defaults to config.
Available since version 1.0.0.
related_orderoptional
The order to sort related posts.
Accepts “asc” (ascending order) or “desc” (descending order).
Defaults to config.
Available since version 1.0.0.
related_itemsoptional
Amount of related posts to show in the author box.
Accepts integer.
Defaults to config.
Available since version 1.0.0.
enable_guest_archiveoptional
Whether to enable guest author archive pages.
Accepts “yes” or “no”.
Defaults to config.
Available since version 1.0.0.
atoptional
The string used to join author job position and company.
Accepts plain text.
Defaults to config.
Available since version 1.0.0.
weboptional
The string used as the text of the link to the author profile page or blog.
Accepts plain text.
Defaults to config.
Available since version 1.0.0.
more_postsoptional
The string used as the text of the toggle to show the related posts of the author.
Accepts plain text.
Defaults to config.
Available since version 1.0.0.
biooptional
The string used as the text of the toggle to show back the author bio.
Accepts plain text.
Defaults to config.
Available since version 1.0.0.
about_the_authoroptional
The string used as the label of “author info” tab on the tabbed layout.
Accepts plain text.
Defaults to config.
Available since version 1.0.0.
related_postsoptional
The string used as the label of “related posts” tab on the tabbed layout.
Accepts plain text.
Defaults to config.
Available since version 1.0.0.
no_related_postsoptional
The string used to say that the author displayed has no (other) related posts.
Accepts plain text.
Defaults to config.
Available since version 1.0.0.
meta_separatoroptional
The symbol displayed between author meta data (position, company, profile link…).
Accepts text and unicode characters.
Defaults to config.
Available since version 1.0.0.
Deprecated Attributes
Listed attributes below were available on previous versions of the plugin, but have been removed or replaced:
authoroptional
Replaced by id.
headline_styleoptional
Replaced by headline_text_align.
headline_sizeoptional
Was available from version 1.3.5 to 3.0.0.
Replaced by headline_text_align.
headline_alignoptional
Was available from version 1.3.5 to 3.0.0.
Replaced by headline_text_align.
headline_coloroptional
Replaced by headline_text_color.
img_styleoptional
Whether and how to shape the author profile image.
Accepted “none”, “rounded”, “circled”.
Defaulted to config.
Was available from version 1.2.14 to 3.0.0.
img_defaultoptional
Default image to show if none uploaded and no gravatar configured.
Accepted “blank”, “mm” (Mistery Man) or “acronym”.
Defaulted to config.
Was available from version 1.2.14 to 3.0.0.
img_borderoptional
Width of the border to add to the author profile image.
Accepted “none”, “thin” or “thick”.
Defaulted to config.
Was available from version 1.3.5 to 3.0.0.
img_border_coloroptional
The border color of the author profile image.
Accepted CSS color values.
Defaulted to config.
Was available from version 1.3.5 to 3.0.0.
img_defaultoptional
Default image to show if none uploaded and no gravatar configured.
Accepted “blank”, “mm” (Mistery Man) or “acronym”.
Defaulted to config.
Was available from version 1.2.14 to 3.0.0.
name_sizeoptional
Font size used to display the author name.
Accepted “biggest”, “bigger”, “big”, “normal”, “small”, “smaller” or “smallest”.
Defaulted to config.
Was available from version 1.2.14 to 3.0.0.
name_coloroptional
Color used to display the author name.
Accepted CSS color values.
Was available from version 1.2.14 to 3.0.0.
name_linkoptional
Whether to underline the author name.
Accepted “yes” or “no”.
Defaulted to config.
Was available from version 1.2.14 to 3.0.0.
