Control the appearance of WordPress post excerpts
A short version of a post that is usually displayed wherever the whole post would be too much (eg. search results, news feeds, archives). You can write them yourself, but if you don't, WordPress will make a very basic one instead.
The default excerpt created by WordPress removes all HTML. If your theme uses
the_content() to view excerpts, they might look weird because of this (smilies are removed, lists are flattened, etc.) This plugin fixes that and also gives you more control over excerpts.
During development, the plugin is tested with the most recent version(s) of WordPress. It might work on older versions, but it's better to just keep your installation up-to-date.
Advanced Excerpt is internationalization (i18n) friendly. If you'd like to contribute a translation for your language please do so by opening a pull request.
Before 4.1, multibyte characters were supported directly by this plugin. This feature has been removed because it added irrelevant code for a 'problem' that isn't actually specific to the plugin.
If you require multibyte character support on your website, you can override the default text operations in PHP.
The plugin automatically hooks on
the_content() functions and uses the parameters specified in the options panel.
If you want to call the filter with different options, you can use
the_advanced_excerpt() template tag provided by this plugin. This tag accepts query-string-style parameters (theme developers will be familiar with this notation).
The following parameters can be set:
length, an integer that determines the length of the excerpt
length_type, enumeration, if set to
wordsthe excerpt length will be in words; if set to
charactersthe excerpt length will be in characters
no_custom, if set to
1, an excerpt will be generated even if the post has a custom excerpt; if set to
0, the custom excerpt will be used
no_shortcode, if set to
1, shortcodes are removed from the excerpt; if set to
0, shortcodes will be parsed
finish, enumeration, if set to
exactthe excerpt will be the exact lenth as defined by the "Excerpt Length" option. If set to
wordthe last word in the excerpt will be completed. If set to
sentencethe last sentence in the excerpt will be completed.
ellipsis, the string that will substitute the omitted part of the post; if you want to use HTML entities in the string, use
%26instead of the
&prefix to avoid breaking the query
read_more, the text used in the read-more link
add_link, if set to
1, the read-more link will be appended; if
0, no link will be added
allowed_tags, a comma-separated list of HTML tags that are allowed in the excerpt. Entering
_allwill preserve all tags.
exclude_tags, a comma-separated list of HTML tags that must be removed from the excerpt. Using this setting in combination with
allowed_tagsmakes no sense
A custom advanced excerpt call could look like this:
No, this plugin fetches the post from The Loop and there is currently no way to pass a post ID or any custom input to it. However, you can start The Loop manually and apply the plugin as usual.
Requires: 3.2 or higher
Compatible up to: 3.9.1
Last Updated: 2014-6-10
23 of 35 support threads in the last two months have been resolved.
Got something to say? Need help?