Kailey (trepmal)

<p>Widget for mini post loops.</p>
<p>Show most recent posts, posts from categories, and more. Can be displayed via widgets, shortcodes, and template tags.</p>
<p>Development is now happening at the <a href="https://github.com/trepmal/mini-loops" rel="nofollow ugc">GitHub Repo</a><br />
Explanation of options:</p>
<h4>Widget Display</h4>
<p><strong>Title:</strong> Your recent posts widget’s title on your sidebar. Default: Recent Posts<br />
    [miniloop title=”Recent Posts”]<br />
    get_miniloops( array(‘title’ => ‘Recent Posts’ ) );</p>
<p><strong>Title URL:</strong> The page the title should link to. Default: none<br />
    [miniloop title_url=”/blog/”]<br />
    get_miniloops( array(‘title_url’ => ‘/blog/” ) );</p>
<h4>Building the Query</h4>
<p><strong>Number of Posts:</strong> Number of posts to be displayed. Default: 3<br />
    [miniloop number_posts=3]<br />
    get_miniloops( array(‘number_posts’ => 3 ) );</p>
<p><strong>Post Offset:</strong> Number of posts to skip before displaying the list. Default: 0<br />
    [miniloop post_offset=0]<br />
    get_miniloops( array(‘post_offset’ => 0 ) );</p>
<p><strong>Maximum Age:</strong> Don’t show posts more than X days old Default: 0<br />
    [miniloop maximum_age=0]<br />
    get_miniloops( array(‘maximum_age’ => 0 ) );</p>
<p><strong>Post Author:</strong> Get author’s post. By ID. Default: none<br />
    [miniloop post_author=0]<br />
    get_miniloops( array(‘post_author’ => 0 ) );</p>
<p><strong>Post Type:</strong> Post type to display. Default: post<br />
    [miniloop post_type=post]<br />
    get_miniloops( array(‘post_type’ => ‘post’ ) );</p>
<p><strong>Post Status:</strong> Post status to display. Primarily useful to show upcoming (future) posts. But be creative! Default: publish<br />
    [miniloop post_status=publish]<br />
    get_miniloops( array(‘post_status’ => ‘publish’ ) );</p>
<p><strong>Order By:</strong> What order the posts should be displayed in. Default: date<br />
    [miniloop order_by=date]<br />
    get_miniloops( array(‘order_by’ => ‘date’ ) );</p>
<p><strong>Order:</strong> Ascending (good for order by title) or Descending (good for order by date) Default: DESC<br />
    [miniloop order=DESC]<br />
    get_miniloops( array(‘order’ => ‘DESC’ ) );</p>
<p><strong>Ordering by the values of <code>some_key</code></strong> (works well if the values of <code>some_key</code> are strings/words):<br />
    [miniloop order_by=meta_value order_meta_key=some_key]<br />
    get_miniloops( array(‘order_by’ => ‘meta_value’, ‘order_meta_key’ => ‘some_key’ ) );</p>
<p><strong>Ordering by the numeric values of <code>some_key</code></strong> (works well if the values of <code>some_key</code> are numbers/integers):<br />
    [miniloop order_by=meta_value_num order_meta_key=some_key]<br />
    get_miniloops( array(‘order_by’ => ‘meta_value_num’, ‘order_meta_key’ => ‘some_key’ ) );</p>
<p><strong>Show posts in reverse order?</strong> Perhaps you want the 3 most recent posts, but you want the oldest of those to be displayed first. If so, check this. Default: 0<br />
    [miniloop reverse_order=0]<br />
    get_miniloops( array(‘reverse_order’ => 0 ) );</p>
<p><strong>Shuffle post order?</strong> Shuffle the order of the posts matching your query. Perhaps showing the 5 most recent posts in randomized order. Default: 0<br />
    [miniloop shuffle_order=0]<br />
    get_miniloops( array(‘shuffle_order’ => 0 ) );</p>
<p><strong>Ignore sticky posts?</strong> Treat sticky posts as normal posts. I recommend ignoring, or the number of posts displayed may be inconsistent. Default: 1<br />
    [miniloop ignore_sticky=1]<br />
    get_miniloops( array(‘ignore_sticky’ => 1 ) );</p>
<p><strong>Exclude sticky posts?</strong> Don’t show sticky posts at all. Default: 0<br />
    [miniloop exclude_sticky=0]<br />
    get_miniloops( array(‘exclude_sticky’ => 0 ) );</p>
<p><strong>Only sticky posts?</strong> Show only sticky posts. Default: 0<br />
    [miniloop only_sticky=0]<br />
    get_miniloops( array(‘only_sticky’ => 0 ) );</p>
<p><strong>If viewing a single post, exclude it?</strong> If viewing a single post, remove it from the widget display. Default: 1<br />
    [miniloop exclude_current=1]<br />
    get_miniloops( array(‘exclude_current’ => 1 ) );</p>
<p><strong>Get posts from current category (if archive)?</strong> If viewing an archive, only show posts from the same category. Default: 0<br />
    [miniloop current_category=1]<br />
    get_miniloops( array(‘current_category’ => 1 ) );</p>
<p><strong>Get posts from first category (if single)?</strong> If viewing a single post, only show posts from the first category. Default: none<br />
    [miniloop current_single_category=1]<br />
    get_miniloops( array(‘current_single_category’ => 1 ) );</p>
<p><strong>Get posts from current author (if single or archive)?</strong> Show more posts from the current author. Default: none<br />
    [miniloop current_author=1]<br />
    get_miniloops( array(‘current_author’ => 1 ) );</p>
<p><strong>Categories:</strong> Comma separated list of category IDs to pull from. Use negative ID numbers to exclude a category. Default: none<br />
    [miniloop categories=”1,8,13″]<br />
    get_miniloops( array(‘categories’ => ‘1,8,13’ ) );</p>
<p><strong>Tags:</strong> Comma separated list of tag IDs to pull from. Use negative ID numbers to exclude a tag. Default: none<br />
    [miniloop tags=”15,40,88″]<br />
    get_miniloops( array(‘tags’ => ‘15,40,88’ ) );</p>
<p><strong>Custom Taxonomies:</strong> A clunky way to support custom taxonomies. Default: none. To include terms 5, 6, 9 from taxonomy “Genre” do this:<br />
    [miniloop tax=”genre=5,6,9″]<br />
    get_miniloops( array(‘tax’ => ‘genre=5,6,9’ ) );</p>
<p><strong>Custom Fields:</strong> For listing posts that have certain meta data. Default: none. To list posts that have a custom field ‘favorite_color’ with a value of ‘blue’ do this:<br />
    [miniloop custom_fields=”favorite_color=blue”]<br />
    get_miniloops( array(‘custom_fields’ => ‘favorite_color=blue’ ) );</p>
<p><strong>Exclude Posts:</strong> A comma separated list of post IDs to exclude. Default: none<br />
    [miniloop exclude=”15,200,1032″]<br />
    get_miniloops( array(‘exclude’ => ‘15,200,1032’ ) );</p>
<h4>Display</h4>
<p><strong>Before Items:</strong> Text/HTML to insert before the post list. Default: <code><ul></code><br />
    [miniloop before_items=””]<br />
    get_miniloops( array(‘before_items’ => ” ) );</p>
<p><strong>After Items:</strong> Text/HTML to insert after the post list. Default: <code></ul></code><br />
    [miniloop after_items=””]<br />
    get_miniloops( array(‘after_items’ => ” ) );</p>
<p><strong>Item Format:</strong><br />
HTML and shortcodes to format each item</p>
<h4>Shortcodes</h4>
<ul>
<li>[ml_title]</li>
<li>[ml_url]</li>
<li>[ml_excerpt] Attributes: length (100), wlength (0), after (‘…’), space_between (0), after_link (1), custom (0), strip_tags (1), strip_shortcodes (1)
<ul>
<li>length = excerpt length in characters (0 for none, -1 for full length)</li>
<li>wlength = excerpt length in words</li>
<li>after = what to show after the excerpt</li>
<li>space_between = force space between excerpt and ‘after’</li>
<li>after_link = make the ‘after’ link to the post</li>
<li>custom = 1 to default/customized excerpts, 0 to trim by lentgh</li>
<li>strip_tags = 1 to strip HTML tags, 0 to keep. <strong>CAREFUL:</strong> it is not generally recommended to keep the tags. Character excerpts may break tags, and thus break an entire page’s layout.</li>
<li>strip_shortcodes = 1 to strip shortcodes, 0 to keep</li>
<li>up_to_more = 1 to get everything up to the <code></code> tag (the ‘more’ text), if it exists, otherwise use char/word limit excerpt. 0 use char/word limited excerpt</li>
<li>after_with_more = (with up_to_more) 1 to use the ‘after’ text with the ‘more’ text, 0 to add nothing after the ‘more’ text</li>
</ul>
</li>
<li>[ml_content]</li>
<li>[ml_comment_count]</li>
<li>[ml_author]</li>
<li>[ml_author_link]</li>
<li>[ml_author_avatar] Attributes: size (92), default (”), alt (false)
<ul>
<li>size = avatar size, in pixels</li>
<li>default = default if no gravatar. See Settings > Discussion</li>
<li>alt = alt text</li>
</ul>
</li>
<li>[ml_field] Attributes: name, single (1), separator (‘, ‘), reverse (0)
<ul>
<li>name = custom field name</li>
<li>single = 1 get single value, 0 get all values matching name</li>
<li>separator = string to separate each value</li>
<li>reverse = 0 default order, 1 reverse display order</li>
</ul>
</li>
<li>[ml_taxonomy] Attributes: taxonomy, separator (‘, ‘), link (0), justone (0), reverse (0)
<ul>
<li>taxonomy = taxonomy slug</li>
<li>separator = string to separate each term</li>
<li>link = 1 to link categories to their archive page, 0 for no links</li>
<li>justone = 1 to show just first category, 0 to show all</li>
<li>reverse = 0 default order, 1 reverse display order</li>
</ul>
</li>
<li>[ml_tax] Alias to [ml_taxonomy]</li>
<li>[ml_category] Shortcut for [tax taxonomy=category]</li>
<li>[ml_tag] Shortcut for [tax taxonomy=post_tag]</li>
<li>[ml_date] Attributes: format (‘F j, Y’)
<ul>
<li>format = PHP-style date format</li>
</ul>
</li>
<li>[ml_class] Attributes: class
<ul>
<li>class = classes to display in addition to the traditional post classes</li>
</ul>
</li>
<li>[ml_image] Attributes: from, cfname, class, width (50), height (50), crop, fallback
<ul>
<li>from (options: thumb, attached, customfield, first)
<ul>
<li><em>from</em> ‘thumb’ post thumbnail/featured image <code>[ml_image from=thumb]</code></li>
<li><em>from</em> ‘attached’ first attached image <code>[ml_image from=attached]</code></li>
<li><em>from</em> ‘customfield’ get from custom field <code>[ml_image from=customfield]</code></li>
<li><em>from</em> ‘first’ first image in post <code>[ml_image from=first]</code></li>
</ul>
</li>
<li>since 1.1.3, you can pass a comma-separated list to use as fallbacks. <code>[ml_image from="thumb,first"]</code></li>
<li>cfname = custom field to use if from=customfield <code>[ml_image from=customfield cfname=thumbnail]</code></li>
<li>class = class for image</li>
<li>width = width of image</li>
<li>height = height of image</li>
<li>crop = 1 to crop, 0 to scale (not implemented yet)</li>
<li>fallback = URL of image to use if ‘from’ doesn’t return anything</li>
<li>cache = set to ‘clear’ to generate new thumbnails. It is not recommended that you leave this option on. <code>[ml_image from=thumb cache=clear]</code></li>
</ul>
</li>
</ul>
<p>Inside of Item Format, shortcodes can be used without the <code>ml_</code> prefix.</p>
<h4>Sample Item Formats</h4>
<p>Format 1: https://s.w.org/extend/plugins/mini-loops/screenshot-2.png</p>
<p>(before: <code><ul></code> after: <code></ul></code>)</p>
<li></li>
<p><a href="[url]" rel="nofollow ugc">[image from=customfield<br />
    cfname=image width=50 height=50 class=alignright<br />
    fallback=’http://dummyimage.com/50′][title]</a><br />
    [excerpt wlength=30 space_between=1 after=”…” after_link=1]</p>
<p>    By [author] on [date format=”n/j/y”]</p>
</p>
<p>Format 2: https://s.w.org/extend/plugins/mini-loops/screenshot-3.png</p>
<p>(before: <code><ul></code> after: <code></ul></code>)</p>
<li></li>
<p>[date format=”F j, Y”]<br /><a href="[url]" rel="nofollow ugc"><br />
    [image from=customfield cfname=image width=180 height=100<br />
    class=aligncenter fallback=’http://placekitten.com/180/100′]</a><br />
    [excerpt length=90 space_between=1 after=”…” after_link=1]</p>
</p>
<p>Format 3: https://s.w.org/extend/plugins/mini-loops/screenshot-4.png</p>
<p>(before: — after: –)</p>
<p><a href="[url]" rel="nofollow ugc">[title]<br />
    [image from=customfield cfname=image width=140 height=140<br />
    class=aligncenter fallback=’http://placepuppy.it/200/300&text=++woof++’]</a></p>
<h3>Template Tag</h3>
<p>use <code>miniloops( $args )</code> or <code>get_miniloops( $args )</code></p>
<p>Like WordPress function, the ‘get_’ variant will simply return the results.</p>
<p>Here are the acceptable arguments and their default values:</p>
<pre><code>$args = array(
        'title' => __( 'Recent Posts', 'mini-loops' ),
        'hide_title' => 0,
        'title_url' => '',
        'number_posts' => 3,
        'post_offset' => 0,
        'post_type' => 'post',
        'post_status' => 'publish',
        'order_by' => 'date',
        'order' => 'DESC',
        'reverse_order' => 0,
        'shuffle_order' => 0,
        'ignore_sticky' => 1,
        'only_sticky' => 0,
        'exclude_current' => 1,
        'categories' => '',
        'tags' => '',
        'tax' => '',
        'custom_fields' => '',
        'exclude' => '',
        'before_items' => '<ul>',
        'item_format' => '<li><a href="[url]">[title]</a><br />[excerpt]</li>',
        'after_items' => '</ul>',
        );
get_miniloops( $args );
</code></pre>
<h4>Shortcode</h4>
<pre><code>[miniloop]
</code></pre>
<p>Use with all args listed above<br />
e.g. <code>[miniloop number_posts=10]</code></p>
<p><strong>Exception – ‘item_format’ must be handled differently</strong></p>
<p>New way (since v0.9):</p>
<p>Create a custom field named <code>ml_format</code> and save the item format there. Then adjust your <code>[miniloop]</code> shortcode<br />
e.g. <code>[miniloop number_posts=10][ml_format][/miniloop]</code></p>
<p>If needed, you can change the custom field. Just pass the name of the new custom field to the <code>[ml_format]</code> shortcode<br />
e.g. <code>[miniloop number_posts=10][ml_format name="new_field"][/miniloop]</code></p>
<p>Old way:</p>
<p>‘item_format’ must go into the content of the shortcode, and square brackets must be replaced with curly brackets.<br />
e.g. <code>[miniloop number_posts=10]{title}by {author}<br />[/miniloop]</code></p>
<p>Also, if you are using html inside the item_format, you must add this into the HTML editor, else your markup will be rendered, not parsed</p>
<h4>Planned</h4>
<ul>
<li>true image cropping for remote images</li>
</ul>
<h3>Other Languages</h3>
<ul>
<li>French (Thanks <a href="http://twitter.com/maoneetag" rel="nofollow ugc">@maoneetag</a>)</li>
</ul>
<h4>Bilingual?</h4>
<p>Send your mo/po files to me at trepmal (at) gmail.com</p>

Mini Loops

Get recent posts, posts from categories, and more. Display as widget or with shortcodes and template tags.

yakuphan

<p>Advanced Most Recent Posts Widget displays your recent posts with thumbnail images (optional). It gets posts from selected categories or current category or all categories. When your visitors are at home, it gets posts from all posts or selected category. If you set ‘Get posts from current category’, when visitors see single post, widget lists posts in the same category of single post or when visitors click a category link, it gets posts from current category.</p>
<p>Check out a brand new plugin inspired by this one: <a href="https://wordpress.org/extend/plugins/mini-loops/" rel="ugc">Mini Loops</a></p>
<p>I’m bad at support (not intentionally). If you have questions: check the forums, then check <a href="http://trepmal.com/plugins/advanced-most-recent-posts-mod/#comments" rel="nofollow ugc">my blog post’s comment thread</a>. If that doesn’t work, post to the forums (there are awesome volunteers out there!) and get my attention by pinging me on twitter <a href="http://twitter.com/trepmal" rel="nofollow ugc">@trepmal</a>.</p>
<h3>Options</h3>
<p>Widget’s options allow you to change your recent posts list displaying.</p>
<h4>Title:</h4>
<p>Your recent posts widget’s title on your sidebar.</p>
<h4>Title Link:</h4>
<p>The page the title should link to.</p>
<h4>Hide Post Title:</h4>
<p>Check to hide post title in output. useful for thumbnail-only displays</p>
<h4>Separator:</h4>
<p>The character to use to separate the title from the excerpt.</p>
<h4>After Excerpt:</h4>
<p>What should appear after the excerpt</p>
<h4>After Excerpt Link:</h4>
<p>should the ‘after excerpt’ text link to the post? useful if ‘after excerpt’ read like “read more…”</p>
<h4>Show:</h4>
<p>The post type to be displayed.</p>
<h4>Number of posts to show:</h4>
<p>How many posts to display</p>
<h4>Excerpt length (letters)</h4>
<p>You know that</p>
<h4>Thumbnail Custom Field Name</h4>
<p>If you want to display the thumbnail of your posts via a custom field, write its name.</p>
<h4>Height – Width</h4>
<p>Images size.</p>
<h4>Get first image of post</h4>
<p>If you don’t want to use custom field, plugin will get first image from your post content.</p>
<h4>Get first attached image of post</h4>
<p>Plugin gets first attached image of post.</p>
<h4>Default image</h4>
<p>If post has no image, plugin display this image. Ex: http://www.yakupgovler.com/default-image.png</p>
<p>Notice: If you use three options, plugin uses custom field image firstly. If the post has no custom field, it gets first image from content. At last it gets first attached image. I suggest not to use “Get first image of post” for performance. It queries much more.</p>
<h4>Show Author</h4>
<p>If checked, shows author next to title</p>
<h4>Show Post Timestamp</h4>
<p>If checked, shows post timestamp</p>
<h4>Time format</h4>
<p>The format to be used when displaying the timestamp</p>
<h4>Put time</h4>
<p>A placement option for the post timestamp</p>
<h4>Categories</h4>
<p>Plugin gets posts in these categories. (Category IDs, separated by commas.)</p>
<h4>Get posts from current category:</h4>
<p>Posts will be get from current category (single post’s category or current category).</p>


Advanced Most Recent Posts Mod

Based off the Advanced Most Recent Posts plugin by Yakup GÖVLER. Display most recent posts from selected categories or current category or all categor …

Mini Loops vs Advanced Most Recent Posts Mod