=== Ultimate Post List ===
Contributors: Hinjiriyo
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=KMNHCY3MZ6D2N
Tags: authors, avatars, css, featured image, first image, grid, list, options, shortcode, thumbnail, widget, load more
Requires at least: 4.0
Requires PHP: 5.2
Tested up to: 4.9.7
Stable tag: 4.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Make up custom-tailored preview lists of the contents easily and place them in widget areas and post contents.

== Description ==

Make up custom-tailored preview lists of the contents easily and place them in widget areas and post contents.

Promote your website’s content with many kinds of post lists. No programming skills are necessary. With just a few keyboard entries and clicks you get a customized posts list. The plugin Ultimate Post List for WordPress gives you an easy-to-use toolbox to make lists of posts.

You can insert the lists
* as **widgets in every widget area** per drag'n'drop easily
* via **configurable shortcodes in every post content**
* via **calls of the function upl_print_list()** in PHP code

You can switch between a **vertical list layout** or a **responsive grid layout**. A few options help you to get a nice layout without any need to code.

You can switch on a **"Load more posts"** link or button which loads further posts without leaving the page. Its text is controlled easily for you.

The plugin is **multi-widget capable**. That is, you can have several widgets of Ultimate Post List on your blog, each with its own settings!

You can clone (duplicate, copy) every list with a single click on the action link.

The plugin is available in English, German (Deutsch) and Greek (Ελληνικά). It does not collect any personal data, so it is ready for EU General Data Protection Regulation (GDPR) compliance.

= Options you can set =

The free version of Ultimate Post List offers you many options to type and click customized post lists easily. These are the options:

* **List Options**
    * **List Display Options**
        * List Visibility
        * Text if no posts
    * **List Title Options**
        * List title
        * URL of list title
        * HTML element of list title
* **Post List Options**
    * **Post List Options In General**
        * Number of posts
        * Posts offset
        * Hide current viewed post in list
        * Show sticky posts on top of the list
    * **Posts Sort Order**
        * **Order by**
            * Post date
            * Post title
            * Post author
        * **Order direction**
            * Ascending
            * Descending
* **Post List Item Options**
    * **Post Data Order**
        * Position of post thumbnail
        * Position of post title
        * Position of post date
        * Position of post author name
    * **Post Display Options**
        * Show post thumbnail (default)
        * Show post title (default)
        * Show post date
        * Show post author name
    * **Post Links Options**
        * Set post title clickable (default)
        * Set post thumbnail clickable (default)
        * Set post date clickable, pointing to the month archive
        * Set post author clickable, pointing to the author&#8217;s archive
        * Open post links in new windows
    * **Post Title Options**
        * Maximum length of post title
        * Text after shortened title
    * **Post Date Options**
        * Format of the post date (over 100 options available)
    * **Post Thumbnail Options**
        * **Source of the post thumbnail**
            * Featured image
            * First post content image
            * Featured image if the first post content image is not available
            * First post content image if the featured image is not available
            * Avatars of post authors
        * **Use default thumbnail if no image could be ascertained**
            * URL of default thumbnail
            * Thumbnail size 
        * Width of thumbnail in px
        * Height of thumbnail in px
        * Use aspect ratios of original images
        * **Alignment of thumbnail**
            * Align left
            * Align center
            * Align right
        * Top image margin width in px
        * Bottom image margin width in px
        * Left image margin width in px
        * Right image margin width in px
* **&#8220;More&#8221; Element Options**
    * **&#8220;More&#8221; Element Appearance**
        * Show a clickable &#8220;More&#8221; element for loading further list items at the bottom of the list
        * **&#8220;More&#8221; element type**
            * Show element as a link
            * Show element as a button
        * Label of &#8220;More&#8221; element
        * Show icon while new posts are loaded
        * **Icon style**
            * **Small icons**
                * Small gray circle with rotating dot
                * Small turning wheel
            * **Big icons**
                * Big gray circle with rotating dot
                * Big turning wheel
        * Text that appears when no further posts have been found
* **List Layout Options**
    * List Layout Type: vertical list or responsive grid
    * Grid item width in px
    * Minimal height of grid item in px
	* **List Item Layout Options**
	    List item layout type (text floats around or is next to the thumbnail)
    * **List Item Margin Options**
        * Top item margin in px
        * Bottom item margin in px
        * Left item margin in px
        * Right item margin in px


= Additional options in the Pro version =

The Pro version has all the options of the free version and many additional options for layouts, colors, custom post types and much more. [Go to Ultimate Post List Pro](https://shop.stehle-internet.de/downloads/ultimate-post-list-pro/).

= Useful hints for developers =

See all informations about shortcode attributes and function parameters in the [Developer Notes](https://shop.stehle-internet.de/developer-notes-for-ultimate-post-list-pro/) of the Pro version. You can use all informations both in this free version and the Pro version.

== Installation ==

= Using The WordPress Dashboard =

1. Navigate to the 'Add New' in the plugins dashboard
2. Search for 'Ultimate Post List'
3. Click 'Install Now'
4. Activate the plugin on the Plugin dashboard
5. Go to 'Ultimate Post List'

= Uploading in WordPress Dashboard =

1. Navigate to the 'Add New' in the plugins dashboard
2. Navigate to the 'Upload' area
3. Select `ultimate-post-list.zip` from your computer
4. Click 'Install Now'
5. Activate the plugin in the Plugin dashboard
6. Go to 'Ultimate Post List'

= Using FTP =

1. Download `ultimate-post-list.zip`
2. Extract the `ultimate-post-list` directory to your computer
3. Upload the `ultimate-post-list` directory to the `/wp-content/plugins/` directory
4. Activate the plugin in the Plugin dashboard
5. Go to 'Ultimate Post List'

== Screenshots ==

1. The edit page of an Ultimate Post List in english language
2. The widget form of an Ultimate Post List in english language
3. Examples of Ultimate Post Lists on one page: lists as content and as widgets
4. Example of an Ultimate Post List widget with avatars of the post authors as thumbnails

== Changelog ==

= 4.1 =
* Added option to display the text next to the thumbnail instead of floating around  it
* Added new function upl_print_list() to call a list in PHP code, documented in the [Developer Notes](https://shop.stehle-internet.de/developer-notes-for-ultimate-post-list-pro/)
* Updated translations
* Tested successfully with WordPress 4.9.4

= 4.0.3 =
* Added greek translation. Thank you, Kostas Arvanitidis!
* Updated translations due to WordPress 4.9
* Tested successfully with WordPress 4.9.1

= 4.0.2 =
* Fixed missing initialization of UPLP options in the frontend

= 4.0.1 =
* Fixed missing detection of custom post types for the list edit page
* Added 'Requires PHP' info in readme.txt

= 4.0 =
* Added "Load more posts" feature (display further posts without page reload)
* Added options for "Load more" button
* Fixed undesired subpage in UPL admin menu if plugin "WordPress Editorial Calendar" is active
* Updated translations

= 3.4.1 =
* Fixed static width of list items if item width is greater than viewport width
* Tested successfully with WordPress 4.8.1

= 3.4 =
* Revised sanitations for texts and URLs on the pages
* Revised translations
* Set activation message as dismissible
* Tested successfully with WordPress 4.8

= 3.3 =
* Added list title option; **important**: Please add the list title in this option if it was shown in post content
* Reordered menu items in navigation; list of lists is main page now
* Revised Help page
* Revised message on plugin activation
* Updated translations

= 3.2 =
* Added on lists table: sortable "Last Modified" column
* Improved on lists table: "Author" column made sortable 

= 3.1.1 =
* Improved performance in getting avatars

= 3.1 =
* Added avatars as new source of thumbnails
* Tested successfully with WordPress 4.7.3

= 3.0.4 =
* Removed 3rd-party metaboxes from list edit page
* Fixed unnecessary loading of CSS and JS on all pages except list edit page
* Tested successfully with WordPress 4.7.2

= 3.0.3 =
* Removed sanitation of post title

= 3.0.2 =
* Added check for loading javascript and CSS only on list edit page
* Revised widget template for more conformity to WP standard widget output
* Tested successfully with WordPress 4.7.1

= 3.0.1 =
* Added new labels to the 'Ultimate Post List' post type, introduced with WordPress 4.7
* Tested successfully with WordPress 4.7
* Updated translations

= 3.0 =
* Added action link 'Copy' to duplicate lists
* Added CSS width limit for selection field in widget control form
* Improved sanitation in admin page: Added check for empty input or no-array input
* Updated translations

= 2.1 =
* Added option for post date format
* Updated translation

= 2.0 =
* Added options for grid layout
* Updated translation
* Tested successfully with WordPress 4.6.1

= 1.2 =
* Revised uninstall function for WordPress 4.6 due to the introduction of WP_Site_Query class
* Fixed translation for WP 4.6
* Tested successfully with WordPress 4.6

= 1.1.0 =
* Fixed: the list always appeared first before other content
* Tested successfully with WordPress 4.5.3

= 1.0.2 =
* Fixed missing descriptions at checkboxes on the options page
* Fixed: outdated translations for post statusses
* Tested successfully with WordPress 4.5.2

= 1.0.1 =
* Shortened readme.txt

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 4.1 =
Added option for text/image circulation, new function upl_print_list(), tested with WordPress 4.9.4

= 4.0.3 =
Added greek translation, updated WP 4.9 translations, tested with WordPress 4.9.1

= 4.0.2 =
Fixed missing UPL options initialization in the frontend

= 4.0.1 =
Fixed missing detection of custom post types, added 'Requires PHP' info in readme.txt

= 4.0 =
Added "Load more posts" feature

= 3.4.1 =
Fixed static width of list items if item width is greater than viewport width, tested with WP 4.8.1

= 3.4 =
Revised sanitations and translations, tested with WordPress 4.8

= 3.3 =
Added list title option, reordered menu items, revised Help page, revised message on plugin activation

= 3.2 =
Added sortable "Last Modified" column, "Author" column made sortable 

= 3.1.1 =
Improved performance in getting avatars

= 3.1 =
Added avatars, tested with WP 4.7.3

= 3.0.4 =
Removed 3rd-party metaboxes, precise loading of CSS and JS

= 3.0.3 =
Removed sanitation of post title

= 3.0.2 =
Slight improvments on CSS loading and HTML output

= 3.0.1 =
Adapted to WordPress 4.7

= 3.0 =
Added action link 'Copy' to duplicate lists

= 2.1 =
Added option for post date format

= 2.0 =
Added options for grid layout, tested with WP 4.6.1

= 1.2 =
Fixed translation for WP 4.6, tested with WP 4.6

= 1.1.0 =
Fixed wrong placement of the list within content, tested with WP 4.5.3

= 1.0.2 =
Fixed errors on the edit page, tested with WP 4.5.2

= 1.0.1 =
Shortened readme.txt

= 1.0.0 =
Initial release.