DLE Collections

Creation of news collections.

SEO

Flexibility to work with SEO collection pages.

Settings

Flexible settings for working with collections.

Automatic

The ability to create automatically filled collections by tag, value of an additional field or search for words in the news.

Templates

Flexibility in working with the design of any pages of collections and their output.

Compatibility

Installation

  • Step one

    Upload files from the Module folder to your server, after changing the name of the folder {THEME} to the name of your template.

  • Step two

    Install the XML file dle-collections.xml via the plugin system depending on your version of DataLife Engine.

  • Step three

    Configure the module in the admin panel.

Update to version 1.3.2

  • Step one

    Replace all files in /engine/lazydev/dle_collections

  • Step two

    Update the module plugin XML in the Plugin Management section depending on your DataLife Engine version.

  • Step three

    Configure the module in the admin panel.

Beginning of work

To display the title (H1) and description (SEO text) on the collection page, insert in main.tpl in the right place: 
{include file="engine/lazydev/dle_collections/index.php?action=template"}

To display the title (H1) on the collection page, insert in main.tpl in the right place: 
{include file="engine/lazydev/dle_collections/index.php?action=template&show=title"}

To display the description (SEO text) on the collection page, paste in main.tpl in the right place: 
{include file="engine/lazydev/dle_collections/index.php?action=template&show=text"}

If you separated the SEO text with the {BREAK} tag and want to display the first part of the text in the right place in your template, in the right place in your main.tpl where the text should be displayed, insert: 
{include file="engine/lazydev/dle_collections/index.php?action=template&show=text&block=top"}

If you separated the SEO text with the {BREAK} tag and want to display the second part of the text in the right place in your template, in the right place in your main.tpl, where the text should be displayed, insert: 
{include file="engine/lazydev/dle_collections/index.php?action=template&show=text&block=down"}

To display collections in a separate place, use the {dle-collections ...} tag: 
{dle-collections id="1-3,5,9-12" not-id="13,4" xfield="x" not-xfield="x" tag="x" not-tag="x" fixed="1" approve="1" order="x" limit="10"}

Parameter Description 
id="x"
 The parameter allows you to display collections by their ID, separated by a comma without spaces. You can also specify a range of collection IDs using dashes. For example, 1,4-8,11 Displays a collection with ID 1, collections with id from 4 to 8, and also with ID 11. 
not-id="x"
 The parameter is completely opposite to the id="list of collections id" parameter and allows you to display collections that do not belong to those specified in the id parameter. For example, {dle-collections not-id="5-10"} will return all collections whose id is not in the range from five to ten. 
xfield="x"
 The parameter allows you to display collections by the value of the additional field that you have selected in the collections. 
not-xfield="x"
 The parameter is completely opposite to the xfield="additional field value" parameter and allows you to display collections that do not belong to the specified value. For example, {dle-collections not-xfield="Tea"} Displays all collections that do not belong to the additional field value - Tea. 
tag="x"
 The parameter allows you to display collections by the value of the tag that you have selected in the collections. 
not-tag="x"
 The parameter is completely opposite to the tag="tag value" parameter and allows you to display collections that do not belong to the specified value. For example, {dle-collections not-xfield="Coffee"} will return all collections that do not belong to the value of the tag - Coffee. 
fixed="x"
 The parameter allows you to display fixed collections or vice versa, 1 - only fixed, 0 - only not fixed. 
approve="x"
 The parameter allows you to display published collections or vice versa, 1 - only published, 0 - only not published. 
order="x"
 The parameter allows you to sort the collections

by_id - by id specified in the id="x"
parameter position_desc - in descending order of positions in the admin panel
position_asc - ascending positions in the admin panel
date_desc - descending date of creation of collections
date_asc - ascending date of creation of collections
edit_desc - in descending order of the collection editing date
edit_asc - in ascending order of collection editing date 
limit="x"
 The parameter allows you to specify the limit for displaying collections.

Module tags

The template file is responsible for the design and display of collections on the page of all collections.
Parameter Description 
{name}
 Displays the name of the collection. 
{title}
 Displays «Title of the collection». 
[title] text [/title]
 Displays the text inside the tags if filled «Title of the collection». 
[not-title] text [/not-title]
 Displays the text inside the tags if empty «Title of the collection». 
{description}
 Displays «Description of the collection». 
{description limit="X"}
 Displays «Description of the collection» without HTML formatting, while the text itself is reduced to the specified X number of characters. 
[description] text [/description]
 Displays the text inside the tags if filled «Description of the collection». 
[not-description] text [/not-description]
 Displays the text inside the tags if empty «Description of the collection». 
{count-news}
 Displays the number of news items in the collection. 
{url}
 Displays a link to the collection. 
{photo}
 Displays a collection poster. 
[photo] text [/photo]
 Displays the text inside the tags if the poster has been loaded. 
[not-photo] text [/not-photo]
 Displays the text inside the tags if the poster has not been loaded. 
{date}
 Displays the date the collection was added as a standard {date} tag for news. 
{date=формат даты}
 Displays the date in the format specified in the tag. Thus, you can display not only the date as a whole, but also its individual parts. The date format is set according to the format accepted in PHP. For example, the {date=d} tag will display the day of the month when the collection was added, and the {date=F} tag will display the name of the month, and the {date=d-m-Y H:i} tag will display the full date and time. 
{edit-date}
 Displays the edit date of the collection if it was edited, works like a standard {date} tag for news. 
{edit-date=формат даты}
 Displays the date in the format specified in the tag. Thus, you can display not only the date as a whole, but also its individual parts. The date format is set according to the format accepted in PHP. For example, the {edit-date=d} tag will display the day of the month when the collection was edited, and the {edit-date=F} tag will display the name of the month, and the {edit-date=d-m-Y H:i} tag will display the full date and time. 
[edit-date] text [/edit-date]
 Displays the text inside the tags if the collection has been edited. 
[not-edit-date] text [/not-edit-date]
 Displays the text inside the tags if the collection has not been edited.
The template file is responsible for displaying collections in the right place.
Parameter Description 
{collection}
 Displays collections if any. 
[collection] text [/collection]
 Displays the text inside the tags if there are collections. 
[not-collection] text [/not-collection]
 Displays the text inside the tags if there are no collections.
The template file is responsible for designing the collections in the right place.
Parameter Description 
{name}
 Displays the name of the collection. 
{title}
 Displays «Title of the collection». 
[title] text [/title]
 Displays the text inside the tags if filled «Title of the collection». 
[not-title] text [/not-title]
 Displays the text inside the tags if empty «Title of the collection». 
{description}
 Displays «Description of the collection». 
{description limit="X"}
 Displays «Description of the collection» without HTML formatting, while the text itself is reduced to the specified X number of characters. 
[description] text [/description]
 Displays the text inside the tags if filled «Description of the collection». 
[not-description] text [/not-description]
 Displays the text inside the tags if empty «Description of the collection». 
{count-news}
 Displays the number of news items in the collection. 
{url}
 Displays a link to the collection. 
{photo}
 Displays a collection poster. 
[photo] text [/photo]
 Displays the text inside the tags if the poster has been loaded. 
[not-photo] text [/not-photo]
 Displays the text inside the tags if the poster has not been loaded. 
{date}
 Displays the date the collection was added as a standard {date} tag for news. 
{date=формат даты}
 Displays the date in the format specified in the tag. Thus, you can display not only the date as a whole, but also its individual parts. The date format is set according to the format accepted in PHP. For example, the {date=d} tag will display the day of the month when the collection was added, and the {date=F} tag will display the name of the month, and the {date=d-m-Y H:i} tag will display the full date and time. 
{edit-date}
 Displays the edit date of the collection if it was edited, works like a standard {date} tag for news. 
{edit-date=формат даты}
 Displays the date in the format specified in the tag. Thus, you can display not only the date as a whole, but also its individual parts. The date format is set according to the format accepted in PHP. For example, the {edit-date=d} tag will display the day of the month when the collection was edited, and the {edit-date=F} tag will display the name of the month, and the {edit-date=d-m-Y H:i} tag will display the full date and time. 
[edit-date] text [/edit-date]
 Displays the text inside the tags if the collection has been edited. 
[not-edit-date] text [/not-edit-date]
 Displays the text inside the tags if the collection has not been edited.
The template file is responsible for the design of the collections that are displayed in the news.
Parameter Description 
{name}
 Displays the name of the collection. 
{title}
 Displays «Title of the collection». 
[title] text [/title]
 Displays the text inside the tags if filled «Title of the collection». 
[not-title] text [/not-title]
 Displays the text inside the tags if empty «Title of the collection». 
{url}
 Displays a link to the collection. 
{photo}
 Displays a collection poster. 
[photo] text [/photo]
 Displays the text inside the tags if the poster has been loaded. 
[not-photo] text [/not-photo]
 Displays the text inside the tags if the poster has not been loaded.
In full news templates, the following tags are available for displaying collections that belong to the news.
Parameter Description 
{collections}
 Displays collections belonging to this news. 
[dle-collections] text [/dle-collections]
 Displays the text inside the tags if there are collections belonging to this news. 
[not-dle-collections] text [/not-dle-collections]
 Displays the text inside the tags if there are no collections that belong to this news.
The template file is responsible for displaying the description on the news page within the collection.
Parameter Description 
{collection}
 Displays the collection data, if any. 
[collection] text [/collection]
 Displays the text inside the tags if there is collection data. 
[not-collection] text [/not-collection]
 Displays the text inside the tags if there is no collection data.
The template file is responsible for formatting the data on the news page within the collection.
Parameter Description 
{name}
 Displays the name of the collection. 
{title}
 Displays «Title of the collection». 
[title] text [/title]
 Displays the text inside the tags if filled «Title of the collection». 
[not-title] text [/not-title]
 Displays the text inside the tags if empty «Title of the collection». 
{description}
 Displays «Description of the collection». 
{description limit="X"}
 Displays «Description of the collection» without HTML formatting, while the text itself is reduced to the specified X number of characters. 
[description] text [/description]
 Displays the text inside the tags if filled «Description of the collection». 
[not-description] text [/not-description]
 Displays the text inside the tags if empty «Description of the collection». 
{count-news}
 Displays the number of news items in the collection. 
{url}
 Displays a link to the collection. 
{photo}
 Displays a collection poster. 
[photo] text [/photo]
 Displays the text inside the tags if the poster has been loaded. 
[not-photo] text [/not-photo]
 Displays the text inside the tags if the poster has not been loaded. 
{date}
 Displays the date the collection was added as a standard {date} tag for news. 
{date=формат даты}
 Displays the date in the format specified in the tag. Thus, you can display not only the date as a whole, but also its individual parts. The date format is set according to the format accepted in PHP. For example, the {date=d} tag will display the day of the month when the collection was added, and the {date=F} tag will display the name of the month, and the {date=d-m-Y H:i} tag will display the full date and time. 
{edit-date}
 Displays the edit date of the collection if it was edited, works like a standard {date} tag for news. 
{edit-date=формат даты}
 Displays the date in the format specified in the tag. Thus, you can display not only the date as a whole, but also its individual parts. The date format is set according to the format accepted in PHP. For example, the {edit-date=d} tag will display the day of the month when the collection was edited, and the {edit-date=F} tag will display the name of the month, and the {edit-date=d-m-Y H:i} tag will display the full date and time. 
[edit-date] text [/edit-date]
 Displays the text inside the tags if the collection has been edited. 
[not-edit-date] text [/not-edit-date]
 Displays the text inside the tags if the collection has not been edited.
The template file is responsible for the design of the news inside the collection
All tags are available as in the short news.
Tags for main.tpl that will work on collection pages.
Parameter Description 
[dle-collection main] text [/dle-collection]
 Displays the text inside the tags on the output page of all collections. 
[dle-collection collections] text [/dle-collection]
 Displays the text inside the tags on the collection page itself. 
[dle-collection X] text [/dle-collection]
 Displays the text inside the tags on the news page within a collection, where X is the CNC (SEO) URL of the collection.

Common mistakes

Set permissions to 666 or 777, depending on your server settings, on the file /engine/lazydev/dle_collections/data/config.php

List of updates

14 September, 2023
1.3.2

FixedFixed a bug with file encoding.

FixedFixed news sorting bug.

13 September, 2023
1.3.1

NewAdded support for webp and jfif images.

NewAdded support for DataLife Engine 16.0 and higher.

NewAdded support for PHP 8.1.

ChangeLocalization has been improved.

ChangeThe minimum PHP version is now 7.2.

FixedFixed a bug with navigation of news within a collections.

FixedFixed a bug with the work of search inside collections.

October 15, 2022
1.3.0

NewAdded support for webp images.

NewNew tag to display only on all pages of the collections themselves.

NewAdded option Exclude categories, news from which will not be added to collections.

NewAdded option Exclude news from collections that will not be searched and taken into account when searching and automatically adding.

NewAdded Ukrainian localization.

NewAdded general global sorting of news in collections.

NewAdded the ability to make automatic collection by search/phrase in the Title of the news, Short and Full news, as well as in additional fields.

NewAdded the ability to specify custom templates for news output and text design for each collection.

NewAdded the ability to specify the number of news per page for each collection.

NewAdded the ability to specify the sorting of news for each collection.

ChangeBreadcrumbs now via json markup.

ChangeChanges in the admin panel of the module for more convenient use.

FixedFixed TinyPng for DataLife Engine 15.0 and higher.

FixedFixed select of a collection when adding / editing news when the option of multicategories is turned off.

FixedFixed removal of a collection if there are files in it.

September 04, 2022
1.2.1

NewAdded support for DataLife Engine 15.0 and above.

FixedFixed various minor bugs.

December 22, 2020
1.2.0

NewAdded an option to customize the sorting of collections on the page of all collections.

NewAdded an option to configure where to get the site name for the og:site_name tag.

ChangeMoved navigation on the collections page to an open file for those who need to customize the design.

ChangeFor collections that do not have a completed Speedbar, the text will be taken from the name of the collection.

ChangeChanged the work of adding news by tag and additional fields.

ChangeFor the og:url tag, the number of the page on which the user is now is also taken.

FixedFixed news sorting on the collection page via the {sort} tag if the cache is enabled in the module settings.

FixedFixed a problem for DataLife Engine 14.1 and higher related to the operation of navigation when the module cache is enabled.

FixedNow the news will be removed from the collection when the news itself is deleted.

October 19, 2020
1.1.0

NewAdded the ability to display h1 and seo text separately.

NewAdded the ability to split seo text to display at the top and bottom of the page.

ChangeNow there will be no notification when adding / editing a collection that you have not selected news for it if you have selected only the value of a tag or an additional field.

FixedFixed a navigation issue on the collection page.

FixedFixed an issue with the notification that a collection has been added/changed.

October 16, 2020
1.0.3

FixedFixed problem with poster and og picture in the admin panel for collections.

FixedFixed a bug with the inability to remove the selected value of a tag or additional field.

FixedFixed issues with displaying news on the collection page when selecting a tag value or an additional field.

October 15, 2020
1.0.2

FixedFixed a problem with displaying data inside the collection.

October 14, 2020
1.0.1

FixedFixed problem with displaying data in the full news.