Description
This plugin allows users to create lists of different types (simple, numbered, cart and poll) and share them.
The items of these lists are the posts of the types to configure (Ex: post, page, product, other CPT, etc).
Create classic lists like Favorites, Bookmarks, Wish List. Or poll lists like “Which one should I buy?”, or shopping cart lists of every month, etc.
It is flexible and extensible.
The plugin adds custom endpoints to the wordpress REST API and includes a client that will display operations on user lists in a modal.
Default lists types
The plugin comes with 6 types of lists:
* Simple: Simple list sorted according to their items added.
* Numbered: List with your numbered items. You can edit the order in which the items will be displayed.
* Poll: You can ask others for their opinion.
* Shopping Cart: List to add items to a virtual cart ( only on Woocommerce ).
* Favorites This type of list conceptually always exists for users, that is, the user does not create them but simply adds items.
* Bookmarks Equivalent to favorites.
All list types can be disabled.
If you are a developer, and you are making a theme you can register your own list types.
Features
- Roles that can create lists is configurable (for each type of list).
- Post type that can be added to lists is configurable (per list type).
- Title and description of the lists can be editable (configurable in each type of list)
- List items can be saved with a comment (configurable in each type of list)
- The lists can be private or public (configurable options in each type of list)
- Max items per list (configurable in each type of list)
- Share buttons for public lists
Collections Archive
The plugin adds a new page to the site where all the collections of the users are shown. This page can be disabled/enabled on the plugin settings.
This page is also used as the basis for displaying each list, but disabling the archive page from the plugin settings does not disable the pages of each collection..
Archive URL example: https://domain.com/user-post-collection/
Collection URL example: https://domain.com/user-post-collection/list-x-by-tauri/
Shortcode
You can use the shortcode [user_posts_collections] to show the lists. Example:
[user_posts_collections type="vote" tpl-items="cards" exclude="32,45"]
[user_posts_collections author="23" tpl-items="list"]
[user_posts_collections limit="5" pagination="1" tpl-cols="4,4,4,3,2,1"]
[user_posts_collections author-name="tauri" orderby="title" order="ASC" limit=10 pagination=1]
[user_posts_collections include="23,31,412"]
Shortcode options
- type: simple|numbered|vote|favorites|bookmarks|cart
- author-name: Author username
- author: Author ID
- include: Lists ID to include (comma separated)
- exclude: Lists ID to exclude (comma separated)
- orderby: ID|views|vote_counter|count|created|modified|title
- order: ASC|DESC
- limit: Max lists to show
- pagination: Show pagination. Set to 1 for enabled. Default: 0
- id: Set unique string. Only letters, numbers and “-“. Used for pagination.
- tpl-items: (card|list) List type
- tpl-cols: Number of columns, comma separated: xxl,xl,lg,md,sm,xs (for card list type) Default: 4,4,4,3,2,1
- tpl-cols-(xs|sm|md|lg|xl|xxl): (1|2|3|4|5) Number of columns (for card list type)
- tpl-thumbs: Default thumbnails layout. Set to “off” to not show
- tpl-thumbs-(xs|sm|md|lg|xl|xxl): (0|2×2|2×3|3×2|4×1|[1-4]x[1-4]) Thumbnails layout
- tpl-desc: (on|off) Show description. Set to “off” to hide description
- tpl-user: (on|off) Show author. Set to “off” to hide user
- tpl-meta: (on|off) Show meta. Set to “off” to hide meta
Screenshots
FAQ
-
You can add a link, with the url “#my-lists”. Then when the user clicks there will appear the modal with the user’s lists.
-
Can I disable a list type?
-
Yes, all list types can be disabled from the plugin settings.
-
I am a developer. Do you have api documentation?
-
Yes, you can read the api documentation by visiting https://tauri77.github.io/user-post-collections/api.html
Reviews
Contributors & Developers
“User Post Collections” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “User Post Collections” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.9.1
- Fixes in translations
0.9.0
- Added archive option
- Added shortcode [user_posts_collections]
0.8.32
- Added show list helper
0.8.31
- Fix “Edit Comment” button
- Added to the configuration “Add to…” string
- Tested on WP 6.1
0.8.30
- Add some themes helper
0.8.29
- Update preact
0.8.28
- Fix some uninstall options
- Fix errors on plain permalinks
0.8.27
- Update author url
0.8.26
- Remove unsafe IP option and use rest_is_ip_address
0.8.25
- Sanitize client IP
0.8.24
- Validate client IP
0.8.23
- First version of the plugin