Molongui Authorship

  1. Molongui
  2. >
  3. Docs
  4. >
  5. Molongui Authorship
  6. >
  7. Shortcodes
  8. >
  9. [molongui_author_box]

[molongui_author_box]

Applies only to the Premium version of the plugin, release 1.2.2 or higher.
Get premium version

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

A trivial shortcode to display a Molongui Author Box looks like this:

Editor input

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam hendrerit ante ac libero imperdiet blandit.
[molongui_author_box]
Phasellus venenatis neque non leo imperdiet pellentesque. Suspendisse varius magna velit, in blandit justo pharetra vel. Vivamus vitae arcu tortor.

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.

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.
idrenamedoptional
The ID of the author to display.
Accepts integer as post ID.
Defaults to current post author ID.
Available since version 3.1.8.
typerenamedoptional
The type of author to display.
Accepts "user" or "guest".
Defaults to user.
Available since version 3.1.8.
layoutoptional
The layout to be used to render the author box.
Accepts "slim", "tabbed" or "stacked".
Defaults to config.
Available since version 1.2.5.
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 3.1.8.
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 3.1.8.
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.3.5.
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.3.5.
box_borderoptional
Box border side(s) to display.
Defaults to config.
Available since version 1.2.14.
box_border_styleoptional
Box border style.
Accepts "solid", "double", "dotted" or "dashed".
Defaults to config.
Available since version 2.1.0.
box_border_widthoptional
Box border width.
Accepts 1 to 10.
Defaults to config.
Available since version 3.0.0.
box_border_coloroptional
Box border color.
Defaults to config.
Available since version 1.2.14.
box_backgroundoptional
Box background color.
Defaults to config.
Available since version 1.3.5.
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.2.14.
show_headlineoptional
Whether to show a headline above the author box.
Accepts "yes" or "no".
Defaults to config.
Available since version 1.3.5.
headlineoptional
The string used as the author box headline.
Accepts plain text.
Defaults to config.
Available since version 1.2.17.
headline_text_sizerenamedoptional
Font size used to display the headline.
Accepts a size from 8 to 100.
Defaults to config.
Available since version 3.0.0.
headline_text_stylerenamedoptional
Font style used to display the headline.
Accepts "normal", "bold", "italic", "underline", "overline" or "overunderline".
Defaults to config.
Available since version 3.0.0.
headline_text_caserenamedoptional
Headline text case.
Accepts "none", "capitalize", "uppercase" or "lowercase".
Defaults to config.
Available since version 3.0.0.
headline_text_alignrenamedoptional
Headline text align.
Accepts "left", "center", "right" or "justify".
Defaults to config.
Available since version 3.0.0.
headline_text_colorrenamedoptional
Headline text color.
Defaults to config.
Available since version 3.0.0.
show_avataroptional
Whether to display the author profile image.
Accepts “yes” or “no”.
Defaults to config.
Available since version 3.0.0.
avatar_stylerenamedoptional
Whether and how to shape the author profile image.
Accepts “none”, “rounded”, “circled”.
Defaults to config.
Available since version 3.0.0.
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 3.0.0.
avatar_border_stylerenamedoptional
Author image border style.
Accepts "solid", "double", "dotted" or "dashed".
Defaults to config.
Available since version 3.0.0.
avatar_border_colorrenamedoptional
Avatar border color.
Defaults to config.
Available since version 3.0.0.
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 3.0.0.
acronym_text_coloroptional
The color used to display the author name acronym.
Defaults to config.
Available since version 1.3.0.
acronym_bg_coloroptional
The color used to fill the author name acronym background.
Defaults to config.
Available since version 1.3.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 3.0.0.
name_text_colorrenamedoptional
Color used to display the author name.
Defaults to config.
Available since version 3.0.0.
name_text_alignoptional
Author name text align
Accepts "left", "center", "right" or "justify".
Defaults to config.
Available since version 3.2.0.
name_inherited_underlinerenamedoptional
Whether to keep theme's underlining the author name.
Accepts "keep" or "remove".
Defaults to config.
Available since version 3.0.0.
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 3.0.0.
show_metaoptional
Whether to show author metadata (job position, company…).
Accepts "yes" or "no".
Defaults to config.
Available since version 1.3.5.
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.2.14.
meta_coloroptional
Color used to display the author metadata (job position, company…).
Available since version 1.2.14.
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.2.14.
bio_coloroptional
Color used to display the author bio.
Available since version 1.2.14.
bio_alignoptional
Text alignment to display the author bio.
Accepts "left", "justify", "center" or "right".
Defaults to config.
Available since version 1.2.14.
bio_styleoptional
Text style to display the author bio.
Accepts "normal", "bold", "italics" or "itbo" (italics-bold).
Defaults to config.
Available since version 1.2.14.
show_iconsoptional
Whether to show the social media icons.
Accepts "yes" or "no".
Defaults to config.
Available since version 1.2.14.
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.2.14.
icons_coloroptional
Color used to display the social media icons.
Available since version 1.2.14.
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.2.14.
bottom_bgoptional
The color used to fill the background of the bottom section on a "ribbon" layout.
Available since version 1.2.14.
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.2.14.
bottom_border_coloroptional
The color of the border to add at the top of bottom section on a"ribbon" layout.
Available since version 1.2.14.
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.2.5.
related_order_byoptional
The criteria to sort related posts.
Accepts "title", "date", "modified", "comment_count" or "random".
Defaults to config.
Available since version 1.2.5.
related_orderoptional
The order to sort related posts.
Accepts "asc" (ascending order) or "desc" (descending order).
Defaults to config.
Available since version 1.2.5.
related_itemsoptional
Amount of related posts to show in the author box.
Accepts integer.
Defaults to config.
Available since version 1.2.5.
enable_guest_archiveoptional
Whether to enable guest author archive pages.
Accepts "yes" or "no".
Defaults to config.
Available since version 1.2.5.
atoptional
The string used to join author job position and company.
Accepts plain text.
Defaults to config.
Available since version 1.3.5.
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.3.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.3.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.3.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.3.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.3.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.3.1.
meta_separatoroptional
The symbol displayed between author meta data (position, company, profile link…).
Accepts text and unicode characters.
Defaults to config.
Available since version 2.0.0.

Deprecated attributes

Below are listed all those attributes that were available on previous versions of the plugin, but have been removed or replaced by others:

authoroptional
The ID of the author to display.
Accepted integer as post ID.
Defaulted to current post author ID.
Was available from version 1.2.5 to 3.1.8.
Replaced by id.
guestoptional
Whether the author to display is a guest author.
Accepted "yes" or "no".
Defaulted to no.
Was available from version 1.2.5 to 3.1.8.
Replaced by type.
headline_styleoptional
Text style to display the headline.
Accepted "normal", "bold", "italics" or "itbo" (italics-bold).
Defaulted to config.
Was available from version 1.3.5 to 3.0.0.
Replaced by headline_text_align.
headline_sizeoptional
Font size used to display the headline.
Accepted "biggest", "bigger", "big", "normal", "small", "smaller" or "smallest".
Defaulted to config.
Was available from version 1.3.5 to 3.0.0.
Replaced by headline_text_align.
headline_alignoptional
Headline text align.
Defaulted to config.
Was available from version 1.3.5 to 3.0.0.
Replaced by headline_text_align.
headline_coloroptional
Headline text color.
Defaulted to config.
Was available from version 1.3.5 to 3.0.0.
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.
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.
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.

More examples

Check out some examples of how the shortcode would look like using different optional attributes:

Displaying current post author box with settings set at plugin page

Journalist at Daily Herald | Website | + posts

This is the bio of Claire Williams, a regular writer on this blog. Here you can write anything you like, even a shortcode! Text styles can also be customized to your needs and likes. On small screens there is no difference between profile layouts. Keep that in mind if you are here using a mobile phone.

Customized background color

Journalist at Daily Herald | Website | + posts

This is the bio of Claire Williams, a regular writer on this blog. Here you can write anything you like, even a shortcode! Text styles can also be customized to your needs and likes. On small screens there is no difference between profile layouts. Keep that in mind if you are here using a mobile phone.

Tabbed layout without shadow and brown author name

Journalist at Daily Herald | Website

This is the bio of Claire Williams, a regular writer on this blog. Here you can write anything you like, even a shortcode! Text styles can also be customized to your needs and likes. On small screens there is no difference between profile layouts. Keep that in mind if you are here using a mobile phone.

Given guest author box with circled profile image

Teacher at Boston University

This is the bio of Nick Goldman, a very special author in my blog. You can write here anything you like even a shortcode! Text styles can also be customized to your needs and likes. Awesome!

Was this article helpful to you? Yes No

How can we help?