=== Post Loop Ajax ===
Contributors: AI.Takeuchi
Description: Post Loop and Pagination Widget. Multiple Posts Loop placement. Auto page feed and at random.
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=P8LCVREFDKWFW
Tags: plugin, widget, post loop, category, pagination, auto page feed, page at random
Requires at least: 4.1
Tested up to: 4.5.3
Stable tag: 1.21
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

== Description ==

Post Loop and Pagination Widget. Multiple Posts Loop placement. Auto page feed and at random.
It works inside Page Builder by SiteOrigin.
Page Builder by SiteOrigin is great plugin.

== Installation ==

1. Install plugin and activate.
2. Placement at widget area.

== Settings ==

= unique id =

Normally enter default.
Checked and enter unique value, if doesn't work.
Will be destroyed this value when copied widget.

= title =

Enter widget title or empty. Checkbox: display or not.

= class =

Specify widget block class.

Default:

    post-loop-ajax-use-default-css

= display posts =

* post type name, separated by comma:

Enter Post Type name, also including Custom Post Type.
Defalut: post

* category name, separated by comma:

* without category name, separated by comma:

* additional (key=value&key2=value2...):

See: https://codex.wordpress.org/Class_Reference/WP_Query

* to result in (query after assembly):

Display query after assembly.

Doesn't work if use this query as argument of WP_Query function.

e.g.

`post_type=(post,topic)&cat=-1,-3`

The expansion of this formula, WP_Query function accept this array.

`
Array(
    ['post_type'] => Array (
        [0] => 'post'
        [1] => 'topic'
    )
    ['cat'] => '-1,-3'
)
`

= posts per page =

Default: 10

= excerpt char length =

Default: 140

= excerpt ellipsis =

Default: "..."

= excerpt more =

Default: Read More

= date time format =

Default:

    F jS, Y

= remember page number until cookie expires =

= pagination type =

    nothing
    normal
    lite
    prev and next only
    multi (for responsive design, see: css/post-loop-ajax.css)

= pagination previous string =

Enter previous navigation button string or empty(defalt button).

= pagination next string =

Enter next navigation button string or empty(defalt button).

= loop timer (0: disabled) =

Enter interval time(sec) to update contents.

= fade time (0: disabled) =

Enter time(msec), use the time while swap contents by fade effect.

= put before and after widget =

= need reload page =

If checked then set page number to cookie then reload page, not use ajax call.

= page at random =

= article =

That have 5th blocks, split by `<!--split-->` tag.

Default:

    `
    <!--header-->
    <div>
        <!-- <div style="overflow-y:auto; height:500px;"> -->
            <!--split-->
            <!--article-->
            <article id="post-%post_id%" %post_class%>
                <header class="entry-header">
                    <h2 class="entry-title"><a href="%permalink%" rel="bookmark">%title%</a></h2>
                </header><!-- .entry-header -->
                <div class="entry-content">
                    <!--
                    %first_image_medium(%permalink%)%
                    %excerpt%
                    -->
                    %content%
                </div><!-- .entry-content -->
                <footer class="entry-footer">
                    <div>Posted by <a href="%author_posts_link%">%author%</a> / %time%</div>
                    <div>Category: %category_links%</div>
                </footer><!-- .entry-footer -->
            </article>
            <!--split-->
            <!--no article-->
            <article id="post-%post_id%" %post_class%>
                <header class="entry-header">
                    <h2 class="entry-title">Not Found</h2>
                </header><!-- .entry-header -->
                <div class="entry-content">
                    <p>Content not found.</p>
                </div><!-- .entry-content -->
                <footer class="entry-footer">
                </footer><!-- .entry-footer -->
            </article>
            <!--split-->
            <!--footer-->
        <!-- </div> -->
        <div>Page: %paged% / %max_number_of_pages% (%number_of_posts% posts)</div>
        %pagination%
    </div>
            <!--split-->
            <!--no article footer-->
        <!-- </div> -->
    </div>
    `

Keyword:

    %post_id%
    %post_class%
    %permalink%
    %title%
    %content%
    %excerpt%
    %category_links%
    %time%
    %author%
    %author_posts_link%
    %pagination%
    %paged%
    %max_number_of_pages%
    %number_of_posts%
    %loop_interval%
    %first_image_sizename()%


== keyword: "%first_image_sizename()%" ==

Replaced this keyword to image html tag / image link.
Used class 'wp-image-??', ?? is image id.

e.g.

    keyword: %first_image_thumbnail%

    put: `thumbnail image url`

    keyword: %first_image_thumbnail(%first_image_large%)%

    put: `<a class="postloopajax-image-link" href="large image url"><img src="thumbnail image url" class="wp-image-??"/></a>`

    keyword: %first_image_medium(%permalink%)%

    put: `<a class="postloopajax-image-link" href="permalink url"><img src="medium image url" class="wp-image-??"/></a>`


== Changelog ==

= 1.21 =

* Fix css.
* Update template html.

= 1.20 =

* Fix, display twice same page when loop is first time.
* Of the excerpt.
* Change way to assemble query.
* "first_image_sizename" keyword addition.

= 1.19 =

* Fix css.

= 1.18 =

* Change way to enter query string.

= 1.17 =

* Fix excerpt permalink.

= 1.16 =

* Change way to enter query string.

= 1.15 =

* Fix the_content filter.

= 1.14 =

* Update html template.

= 1.13 =

* Fix page at random function.

= 1.12 =

* Page at random function addition.

= 1.11 =

* Fix wp-query.

= 1.10 =

* Internationalization.

= 1.9 =

* Added css file.

= 1.8 =

* Function addition.

= 1.7 =

* Fix input tag.

= 1.6 =

* Published.


== Screenshots ==

1. Setting Screen
2. Screenshot


== Frequently Asked Questions ==

= How to include bbPress topics in it? =

Enter "topic" to post type field.

see: https://codex.wordpress.org/Class_Reference/WP_Query