{"id":1741,"date":"2018-04-19T01:56:14","date_gmt":"2018-04-19T01:56:14","guid":{"rendered":"http:\/\/sparepencil.com\/?p=1741"},"modified":"2018-04-26T09:51:37","modified_gmt":"2018-04-26T09:51:37","slug":"advanced-excerpt-plugin-download-instructions","status":"publish","type":"post","link":"https:\/\/sparepencil.com\/en\/advanced-excerpt-plugin-download-instructions\/","title":{"rendered":"Advanced Excerpt Plugin &#8211; Download &#038; Instructions"},"content":{"rendered":"<div class=\"entry-content-text\" itemprop=\"text\"><p id=\"post-111\">The below text is out of date. Here is the current download link to the <a href=\"https:\/\/nl.wordpress.org\/plugins\/advanced-excerpt\/\">WordPress plugin<\/a>, the advanced excerpt plugin. The plugin is still active, and many people are using (90K+), but the Plugin has not been updated for over 2 years.<\/p>\n<p>This plugin adds several improvements to WordPress\u2019 default way of creating excerpts.<\/p>\n<ol>\n<li>It can keep HTML markup in the excerpt (and you get to choose which tags are included)<\/li>\n<li>It trims the excerpt to a given length using either character count or word count<\/li>\n<li>You can customise the excerpt length and the ellipsis character that will be used when trimming<\/li>\n<li>The excerpt length is\u00a0<em>real<\/em>\u00a0(everything belonging to HTML tags is not counted)<\/li>\n<li>Possibility to ignore custom excerpts and use the generated one instead<\/li>\n<li>Theme developers can use\u00a0<code>the_advanced_excerpt()<\/code>\u00a0for even more control (see the FAQ)<\/li>\n<\/ol>\n<p>In addition to keeping HTML markup in the excerpt, the plugin also corrects HTML that might have been broken due to the trimming process.<\/p>\n<p>Version 0.2.1 adds support for multibyte characters (eg. Chinese and Japanese). This is slightly experimental, more details in the FAQ.<br \/>\nPlugin translations are fully supported and language files are included for translation. The FAQ provides more info on this, also.<\/p>\n<h2>Installation<\/h2>\n<p>After you\u2019ve downloaded and extracted the files:<\/p>\n<ol>\n<li>Upload the complete\u00a0<code>advanced-excerpt<\/code>\u00a0folder to the\u00a0<code>\/wp-content\/plugins\/\u00a0<\/code>directory<\/li>\n<li>Activate the plugin through the \u2018Plugins\u2019 menu in WordPress<\/li>\n<li>Go to \u2018Excerpt\u2019 under the \u2018Options\u2019 tab and configure the plugin<\/li>\n<\/ol>\n<h2>Frequently Asked Questions<\/h2>\n<h3>Why do I need this plugin?<\/h3>\n<p>The default excerpt created by WordPress removes all HTML. If your theme uses\u00a0<code>the_excerpt()<\/code>\u00a0to view excerpts, they might look weird because of this (e.g. smilies are removed, lists are flattened, etc.) This plugin fixes that and also gives you more control over excerpts.<\/p>\n<h3>Does it work for WordPress version x.x.x?<\/h3>\n<p>I haven\u2019t had the chance to test the plugin on many versions of WordPress. It has been tested on 2.2 through 2.7, but it might work on other versions, too. You can safely try it yourself, because the plugin is unlikely to break anything (it\u2019s only an output filter). Please let me know if you succesfully tested it on another version of WordPress.<\/p>\n<h3>Is this plugin available in my language? \/ How do I translate this plugin?<\/h3>\n<p>The plugin comes bundled with a few languages. The correct language will automatically be selected to match your\u00a0<a href=\"http:\/\/codex.wordpress.org\/WordPress_in_Your_Language\">WordPress locale<\/a>.<\/p>\n<p>More information on translation will be added in the future.<\/p>\n<h3>Does this plugin support multibyte characters, such as Chinese?<\/h3>\n<p>First of all, it should be noted that word-based excerpt length only works if your language uses normal whitespace as a word separator. If you use another language, you have to uncheck the\u00a0<em>Use words?<\/em>\u00a0option.<\/p>\n<p>PHP\u2019s support for multibyte characters is not perfect. The plugin provides support for these characters to the best of its ability, but there are no guarantees that everything will work.<br \/>\nYour best bet is to use UTF-8 encoding (which WordPress uses by default). If you still encounter problems, check with your host if the\u00a0<em>mbstring<\/em>\u00a0PHP extension is enabled on your server.<\/p>\n<h3>Can I manually call the filter in my WP templates, for example?<\/h3>\n<p>The plugin automatically hooks on\u00a0<code>the_excerpt()<\/code>\u00a0function and uses the parameters specified in the options panel.<\/p>\n<p>If you want to call the filter with different options, you can use\u00a0<code>the_advanced_excerpt()<\/code>\u00a0template tag provided by this plugin. This tag accepts\u00a0<a href=\"http:\/\/codex.wordpress.org\/Template_Tags\/How_to_Pass_Tag_Parameters#Tags_with_query-string-style_parameters\">query-string-style parameters<\/a>\u00a0(theme developers will be familiar with this notation).<\/p>\n<p>The following parameters can be set:<\/p>\n<ul>\n<li><code>length<\/code>, an integer that determines the length of the excerpt<\/li>\n<li><code>use_words<\/code>, if set to\u00a0<code>1<\/code>, the excerpt length will be in words; if set to\u00a0<code>0<\/code>, characters will be used for the count<\/li>\n<li><code>no_custom<\/code>, if set to\u00a0<code>1<\/code>, an excerpt will be generated even if the post has a custom excerpt; if set to\u00a0<code>0<\/code>, the custom excerpt will be used<\/li>\n<li><code>ellipsis<\/code>, the string that will substitute the omitted part of the post; if you want to use HTML entities in the string, use\u00a0<code>%26<\/code>\u00a0instead of the\u00a0<code>&amp;<\/code>\u00a0prefix to avoid breaking the query<\/li>\n<li><code>exclude_tags<\/code>, a comma-separated list of HTML tags that must be removed from the excerpt<\/li>\n<li><code>allow_tags<\/code>, a comma-separated list of HTML tags that are allowed in the excerpt<\/li>\n<\/ul>\n<p>A custom, advanced excerpt call could look like this:<\/p>\n<pre><code>the_advanced_excerpt('length=320&amp;use_words=0&amp;no_custom=1&amp;ellipsis=%26hellip;&amp;exclude_tags=img,p,strong');\r\n<\/code><\/pre>\n<h3>Does this plugin work outside the Loop?<\/h3>\n<p>No, this plugin fetches the post from The Loop and there is currently no way to pass a post ID or anything custom of that kind to it.<br \/>\nYou can, however, consider to\u00a0<a href=\"http:\/\/codex.wordpress.org\/The_Loop#Multiple_Loops\">start The Loop manually<\/a>.<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>The below text is out of date. Here is the current download link to the WordPress plugin, the advanced excerpt plugin. The plugin is still active, and many people are using (90K+), but the Plugin has not been updated for over 2 years. This plugin adds several improvements to WordPress\u2019 default way of creating excerpts. [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":1742,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"jetpack_publicize_message":"","jetpack_is_tweetstorm":false,"jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","enabled":false}}},"categories":[41],"tags":[],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"https:\/\/sparepencil.com\/wp-content\/uploads\/2018\/04\/pexels-photo-261662.jpeg","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pe941-s5","_links":{"self":[{"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/posts\/1741"}],"collection":[{"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/comments?post=1741"}],"version-history":[{"count":1,"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/posts\/1741\/revisions"}],"predecessor-version":[{"id":1743,"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/posts\/1741\/revisions\/1743"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/media\/1742"}],"wp:attachment":[{"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/media?parent=1741"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/categories?post=1741"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sparepencil.com\/en\/wp-json\/wp\/v2\/tags?post=1741"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}