Lists documentation

Lists - Post Types engine documentation

Lists allow you to create repeated contents based on the same template and automatically display them with components like the grid list. A list is a combination of 2 parts: the single item and the archive page the show all items, every item has a dedicated page. Lists are very easy to use and can be used for all your contents of same type, for example you can use list for create: portfolio, team, blog posts, travels or every thing you can immaginate.



Create a Post Type with the Lists

This example show you how to create, show and manage a list.

1. Create the Post Type
  • Go to WordPress menu > Lists and click on Add new
  • On top box select the icon and insert name (ex. Travels) , singular name (ex. Travel) and the ID (ex. travels) with the texts you want. Name and singular name must be the same name in plural and singular version. ID must not contain special chars
  • Click right blue button: Pubblish

2. Create the item template
  • On the same page (Lists > Travels) you can see the editor area where you can create your template
  • Click on + button and add the contents you want
  • The template save everything: components with his settings and contents
  • The template editor not have a preview feature, so the best way to build your template is to create a temporary page or travel and use it for create the template, when you're done save the page as template, come back on template editor (Lists > Travels) and load the template
  • Another way to load the template is to set composer mode to classic, copy the content, come back to template editor and paste the content with composer mode classic

3. Create the archive page
  • On the same page (ex. Lists > Travels) click on blue button Edit archive
  • This is the main archive page but you can add all the archives you want as standard page
  • To show the items you can use the following components: Grid list - Post types, Masonry list - Post types, Slider - Post types, Coverflow - Post types
  • To view the page save the changes, come back to Lists > Travels page and click View archive
  • A complete documentation for the archive and post type components is available below

4. Add the items
  • You can now add your items from WordPress menu > Your list > Add new (ex. WordPress menu > Travels > Add new)
  • On right box you can see the global items contents: Image, excerpt text, extra 1, extra 2 and icon. These contents are used in all the post type components. Image and excerpt text are required.

Lists components




Translations

Translate the lists require WPML, go to translations documentation for more details.
If WPML is active follow these steps to translate the lists:
  • Open an item of the list (WordPress menu > Your list > item)
  • Scroll the page to bottom and you will see the box Multilingual Content setup
  • Check the Make 'Your list' translatable, click apply and wait some second
  • Save the item by click on blu button on top right: Update
  • Now the list is translatable, you can crate the translated version of the item by click on + blu button of WPML

Category translations

  • Go to WPML > Translations options
  • Scroll bottom to Custom taxonomies area and select the category of the list, ex. portfolio-cat, and click save.
  • Come back to the categories page and you will be able to translated them.




Options and extra


Custom content for single item
All items of your list are based on the same template but you can insert custom content for every single item. For do this open the item you want to edit and click two times on top right lock icon .

Delete and create again the Post Type
If there is some error or problem you can delete a list and create it again, the items will not be deleted, but the new list must use the same ID.

Categories
All lists support the categories. You can mange its from WordPress menu > Your list > Categories. To assign a category to a single item open the item and select the category on the bottom right box. You can select multiple categories. All post type components support the categories. If you get a Page Not Found error on category pagination go to Settings > Reading and set the post numbers with number < 10.