Post Info Items
Configure a
Kicker , a
Byline and a
Footer
for posts and pages by arranging these
Post Info Items .
Some of these post info items have one or several
parameters :
You can leave parameters empty but do not remove their single quotes, even if the parameter is empty.
Replace the parameter delimiter with what you want to put between the list
items of the tag or category list, i.e. a comma.
Replace the parameters before and after with what you want to
display before or after that info item. If an item has these "before/after" parameters, use
them instead of hard coding text before and after that item: Example: Use
%tags-linked('Tags: ', ', ', ' - ')%
Tags: %tags-linked('', ', ', '')% -
Replace the parameter linktext with the link text for that item.
HTML and
icons can be used, inside of parameters, too, just not inside the date item:
<image(someimage.gif)> to include an image.
Note: The image item doesn't have quotes
To use your own images, upload them to /[theme-folder]/images/icons/
Icons
Currently available images (Once you uploaded yours they will be listed here):
$file) {
echo '
<image('.$file.')>';
} ?>
Examples
Examples for
Post Bylines :
By %author%, on %date('F jS, Y ')%<strong>%author-linked%</strong> posted this in <strong>%categories-linked(', ')%
</strong> on <em>%date('F jS, Y ')%</em><image(user.gif)> %author-linked% <image(date.gif)> %date('l, jS #of F Y #a#t h:i:s A ')%
Examples for
Post Footers :
%tags-linked('<strong>Tags:</strong> ', ', ', ' — ')%
<strong>Categories:</strong> %categories-linked(', ')% —
%comments('Nobody has commented yet, kick it off... ', 'One comment so far ', '% people had their say - be the next! ',
'Sorry, but comments are closed ')% —
%wp-print% — %wp-email% — %sociable% — %wp-postviews%
Post Info Items
List of available post info items:
%author% - Displays the value in the user's Display name publicly as field.
%modified-author% - For
WordPress 2.8 and newer
ONLY :
Displays the value in the Display name publicly as field, of the author who last modified a post.
This will not work in WordPress 2.7 and older.
%author-description% - Displays the contents of the About yourself field in an
author's profile (Administration > Profile > Your Profile).
%author-login% - Displays the login name of the author of a post. The login is also
referred to as the Username an author uses to gain access to a WordPress blog.
%author-firstname% - Displays the first name for the author of a post. The First Name
field is set in the user's profile (Administration > Profile > Your Profile).
%author-lastname% - Displays the last name for the author of a post. The Last Name field
is set in the user's profile (Administration > Profile > Your Profile).
%author-nickname% - Displays the nickname for the author of a post. The Nickname field
is set in the user's profile (Administration > Profile > Your Profile).
%author-id% - Displays the unique numeric user ID for the author of a post; the ID is
assigned by WordPress when a user account is created.
%author-email-clear% - Displays the email address for the author of a post. The E-mail
field is set in the user's profile (Administration > Profile > Your Profile). Note that the address
is not encoded or protected in any way from harvesting by spambots. For this, see
%author-email%.
%author-email% - Displays the email address for the author of a post, obfuscated by using
the internal function antispambot() to encode portions in HTML character
entities (these are read correctly by your browser).
%author-url% - Displays the URL (not a full link) to the Website for the author of a post. The Website field
is set in the user's profile (Administration > Profile > Your Profile).
%author-link% - Displays a link to the Website for the author of a post. The Website field is
set in the user's profile (Administration > Profile > Your Profile). The text for the link is the author's
Profile Display name publicly as field.
%author-posts-link% - Displays a link to all posts by an author. The link text is the user's
Display name publicly as field.
%author-post-count% - Displays the total number of posts an author has published. Drafts and
private posts aren't counted.
%author-aim% - Displays the AOL Instant Messenger screenname for the author of a post.
The AIM field is set in the user's profile (Administration > Profile > Your Profile).
%author-yim% - Displays the Yahoo IM ID for the author of a post. The Yahoo IM field is
set in the user's profile (Administration > Profile > Your Profile).
%date('F jS, Y')% - Display the date and/or time the post was published at. Many configuration
options at
PHP Date . Because most letters of the alphabet represent
a certain PHP date/time function, you need to
escape each letter that you want to
display LITERALLY. To
escape a letter, put a hash character
# right before that letter.
(Note that this is different from the original "PHP way" of escaping with backslashes
\. The theme
needs the hash character
#). The hash will tell the theme that you mean the actual letter and not the
corresponding PHP date/time function.
How to escape literal letters
on -> #o#n
of -> #of (Note how the the lowercase f didn't get a #.
That's because f is one of the letters of the alphabet that does not represent a
PHP date function)
at -> #a#t
the -> #t#h#e
The arrows just illustrate how to change a word to display it literally inside a date function, don't use them
Examples:
%date('F j, Y, #a#t g:i a ')% displays: December 10, 2008, at 5:16 pm a and t of the word at are
escaped with #
to display them literally instead of interpreting them as PHP date/time function.
%date('F j, Y, g:i a ')% displays: December 10, 2008, 5:16 pm
%date('m.d.y ')% displays: 10.12.08
%date-modified('F jS, Y')% - Same as above but displays the post's last modfied date instead of its creation date.
%tags-linked('before', 'delimiter', 'after')% - Displays the tags associated with
the current post. The name of each tag will be linked to the relevant 'tag' page.
Example: %tags-linked('Tagged with: ', ' - ', '. ')%
%tags-cats-linked('before', 'delimiter', 'after')% - Same as above but if no tags
are associated with the current post, the associated category is displayed instead.
Example: %tags-linked('Filed under: ', ' - ', '. ')%
%tags('before', 'delimiter', 'after')% - Displays the tags associated with
the current post. Tags are not linked.
Example: %tags-linked('Tags: ', ' - ', '. ')%
%category% - Displays the name of the
first category a post belongs to.
%category-linked% - Displays a link to the
first category a post belongs to.
%categories('delimiter')% - Displays the names of all categories a post belongs to, separated
by delimiter.
Example: %categories(', ')%
%categories-linked('delimiter')% - Displays links to all categories a post belongs to, separated
by delimiter.
Example: %categories-linked(' | ')%
%comments('No comments', '1 comment', '% comments', 'Comments closed')% - Displays a
link to the comment section of the post. The link text depends on the comment count & status (open/closed).
When using this item, provide 4 text strings for the 4 possible comment states:
Replace 'No Comments' with your link text for posts that have no comments yet
Replace '1 comment' with your text for posts with 1 comment
Replace '% comments' with your text for posts with 2 or more comments. The % (percent) character
will be replaced with the comment count. Use that character in your own text, too, unless you do not want to display the comment count.
Replace 'Comments closed' with your text for posts where comments are closed. Replace 'Comments closed' with 'dontshow'
to display nothing if comments are closed (instead of displaying something like 'Comments closed')
Example:
%comments('Leave your comment ', 'One comment so far ', '% people had their say - chime in! ',
'Sorry, but comments are closed ')%
Example 2: %comments('Comments ', 'Comments (1) ', 'Comments (%) ', 'dontshow ')%
NOTE: On single post pages the
%comments('...')% link won't display anything because the comments are on the same page.
If you still
want to link to the comments, the comment section and the comment form start with named anchors, so you use something like this:
<?php echo '<a href="'.bfa_getH().'comments">Skip to comments</a>'; ?> or
<?php echo
'<a href="'.bfa_getH().'commentform">Skip to comments form</a>'; ?>
%comments-rss('linktext')% - Displays the comment feed link for a post, with linktext as the link text.
%trackback% - Displays the trackback URL for the current post.
%trackback-linked('linktext')% - Displays a link to the trackback URL, with linktext as the link text.
%trackback-rdf% - Displays the trackback RDF information for a post. This information is not displayed
in a browser. Its use is partly intended for auto-detection of the trackback URI to a post, which can be "trackbacked"
by some blogging and RDF tools. Use this tag if you want to enable auto-discovery of the trackback URI for a post.
Without it, people who wish to send a trackback to one of your posts will have to manually search for the trackback URI.
%permalink% - Displays the URL for the permalink to the post.
%post-id% - Displays the numeric ID of the post.
%post-title% - Displays the title of the post.
%post-title-encoded% - Displays the title of the post. It somewhat duplicates the functionality of
&post-title%, but provides a 'clean' version of the title by stripping HTML tags and converting certain characters
(including quotes) to their character entity equivalent. Use this i.e. for the title tag of a link, example:
<a href="..." title="
%post-title-encoded% ">
%edit('before', 'linktext', 'after')% - Displays a direct edit link for the post, IF the current viewer
is permitted to edit posts, with
linktext as the link text.
Example: %edit(' - ', 'Edit This Post ', '')%
%print('linktext')% - Displays a link with
linktext as the link text, which, when clicked,
will start printing the content of the center column of the current page, without header, sidebars and footer.
Example: %print('Print this Page ')%
%wp-print% - Displays a link to a print preview page of the post. A configurable alternative to the
theme's own basic print function (which prints right away, without preview page). Requires the plugin
WP-Print .
After you installed this plugin, customize the output at the
WP-Print Options Page .
%wp-email% - Displays a link to a form where visitors can e-mail the post to others. Requires
the plugin
WP-Email .
After you installed this plugin, customize the output at the
WP-Email Options Page .
Suggested settings:
Change settings in the section "E-Mail Styles" to customize the output of this item
Make other changes as you see fit
Click "Save Changes"
%wp-postviews% - Displays how many times the post was viewed. Requires the plugin
WP-PostViews .
After you installed this plugin, customize the output at the
WP-PostViews Options Page .
Suggested settings:
Change "Views Template" to customize the output of this item
Make other changes as you see fit
Click "Save Changes"
%wp-postratings% - Displays stars or other graphics showing the vote/rating of a post, and lets visitors rate the post.
Requires the plugin
WP-PostRatings .
After you installed this plugin, customize the output at the
WP-PostRatings Options Page .
Suggested settings:
Delete <br />%RATINGS_TEXT% from the bottom of the textarea named "Ratings Vote Text:"
Delete <br />%RATINGS_TEXT% from the bottom of the textarea named "Ratings None:"
Make other changes as you see fit
Click "Save Changes"
%sociable% - Displays little icons, linking the post to social bookmark sites. Requires the plugin
Sociable . Customize the output at the
Sociable Options Page .
Suggested settings:
"Tagline:" - Will be ignored "Position:" - Uncheck all boxes "Use CSS:" - Uncheck this
"Open in new window:" - Check or uncheck, will be used Click "Save Changes"
%share-this% - Displays little icons, linking the post to social bookmark sites. Requires the plugin
Share This .
%meta% - Displays all custom fields and their values as unordered list
<ul><li>..</li><li>..</li></ul>
%meta('fieldname')% - Displays the value of the custom field with the field name "fieldname".
Example: %meta('price ')%