=== 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, effects
Requires at least: 4.1
Tested up to: 4.6
Stable tag: 1.39
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 ==

= system =

* unique id

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

* remember page number until cookie expires

Defalut: 7 days

= 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

= 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).

= scroll to content top after rewrite content by ajax, without while loop enabled =

* scroll speed (-1: disabled)

Defalut: 200 (msec)

* scroll offset top

Defalut: -150 (px)

* scroll offset top margin

Defalut: 20 (px)

= auto loop contents =

* loop interval time (0: disabled)

Defalut: 0

* time until changed contents

Defalut: 500 (msec)

* page at random

= effects =

Using jQuery UI Effects.

* don't display loading image.

checked or unchecked

* front

select front effect types

* end

select end effect types

= put before and after widget =

= need reload page =

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

= template =

Enter or select template.

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%
    %avatar_image_size()%
    %pagination%
    %paged%
    %max_number_of_pages%
    %number_of_posts%
    %loop_interval%
    %first_image_sizename()%


== keyword: "%avatar_image_size()%" ==

Replaced this keyword to avatar image / image link.

* size is pixel size. max 512.

e.g.

    keyword: %avatar_image_96%

    put: `author image` 96px size

    keyword: %avatar_image_16(%author_posts_link%)%

    put: `<a class="postloopajax-avatar-image-link postloopajax-avatar-image-link-??" href="author posts link url"><img src="avatar image url"/></a>`

    ?? is author id


== 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.39 =

* Modify: way to checking for null.

= 1.38 =

* Modify: way to checking for null.

= 1.37 =

* Modify function: scroll to content top after reloaded.

= 1.36 =

* Modify function: scroll to content top after reloaded.

= 1.35 =

* Additional function: scroll to content top after reloaded.

= 1.34 =

* preg_split instead of split function.

= 1.33 =

* Fixed ajax timeout and error.

= 1.32 =

* Fixed Templates

= 1.31 =

* Fixed of the Effects.
* Update readme.txt

= 1.30 =

* Modify, display loading image to suitable Y position.
* Can select effects type at while rewrite contents.
* "avatar_image_size" keyword addition.
* Some fix.

= 1.29 =

* Fixed, missing get_magic_quotes_gpc and stripslashes.

= 1.28 =

* Changed the criteria of scroll coordinate.

= 1.27 =

* Fixed of the scroll speed.

= 1.26 =

* Updete internationalization.

= 1.25 =

* Additional function: scroll to content top after rewrite content by ajax, without while loop enabled.

= 1.24 =

* Internationalization and some fixed.

= 1.23 =

* Bug fixed of Template Editor.

= 1.22 =

* Template Editor addition.

= 1.21 =

* Fixed css.
* Update template html.

= 1.20 =

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

= 1.19 =

* Fixed css.

= 1.18 =

* Change way to enter query string.

= 1.17 =

* Fixed excerpt permalink.

= 1.16 =

* Change way to enter query string.

= 1.15 =

* Fixed the_content filter.

= 1.14 =

* Update html template.

= 1.13 =

* Fixed page at random function.

= 1.12 =

* Page at random function addition.

= 1.11 =

* Fixed wp-query.

= 1.10 =

* Internationalization.

= 1.9 =

* Added css file.

= 1.8 =

* Function addition.

= 1.7 =

* Fixed input tag.

= 1.6 =

* Published.


== Screenshots ==

1. Screenshot
2. Placement, Widget back-end by Page Builder SiteOrigin
3. Setting Screen
4. Template Editor


== 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