Overview
Soldev gives users the power to create a module to draft and publish news entries to keep their customers up to date with the most recent company news. This tutorial shows users how to create a news module in Solodev where they can add entries with no coding knowledge. This module requires an index page and a detail page. The index page contains the repeater template and the detail page contains the detail template.
Prerequisites
Users should be familiar with:
Using shortcodes.
Mapping pages to modules.
Step 1 – Installing a news module
On the Solodev dashboard, click Modules.
Click Add Module on the next page.
On the News Desk card, click Install.
In the modal window enter the name of the module.
Click Browse and select the web files -> managers folder.
Click Choose.
Click Submit.
Step 2 – Creating a repeater template
Expand the web files -> content folders and open the news folder (Create one in the content folder if it has not been created).
In the news folder, click Add File.
Enter the Name (news-repeater.tpl) and Title of the file.
Set the File Type to Code.
Click Submit.
The user is directed to the open file.
In the text box, enter the code provided below:
<div class="row">
[repeater id='##' pages="22" order="start_time desc" display_type="news"]
<div class="col-sm-6 col-lg-4 mt-4">
<div class="bg-light-gray bg-hover-light-gray-dark pointer box-sizing h-100" onclick="location.href='{{path}}'">
<img alt="{{event_title}}" src="[get_asset_file_url id='{{news_image}}']" class="img-fluid h-200p cover w-100">
<div class="p-3 p-lg-4">
[entry_categories_repeat id="{{calendar_entry_id}}"]
<a class="btn btn-outline-secondary rounded-0 p-1 px-3" href="/news/{{{name}}}">{{{title}}}</a>
[/entry_categories_repeat]
<h2 class="h4 mt-4 post-intro">
[is_set value="{{heading_title}}"]
<a class="text-secondary" href="{{path}}">{{heading_title}}</a>
[/is_set]
[is_empty value="{{heading_title}}"]
<a class="text-secondary" href="{{path}}">{{event_title}}</a>
[/is_empty]
</h2>
<p class="text-muted small">
[print_date format="F d, Y" timestamp="{{start_time}}"]
</p>
<p class="post-intro">{{post_intro}}</p>
</div>
</div>
</div>
[/repeater]
</div>
Click Publish.
Note: The id value in the repeater should match the id value of the module.
Step 3 – Creating a detail template
Open the news folder located in web files -> content folder.
Click Add File.
Enter the Name (news-detail.tpl) and Title of the file.
Set the File Type to Code.
Click Submit.
The user is directed to the open file.
In the text box, enter the code provided below:
[entry]
[is_set value={{post_intro}}]
<h2 class="mb-0 h3">{{post_intro}}</h2>
[/is_set]
<img alt="{{event_title}} Image" class="img-fluid my-5" src="[get_asset_file_url id={{news_image}}]">
{{post_content}}
[/entry]
Click Publish.
Step 4 – Creating a page to house the repeater template
Open the www folder.
Click Add Folder.
Enter the Name (news), Title, and Description of the folder.
Click Submit.
Open the news folder.
Click Add Page.
Enter the Name (index.stml), Title and Description of the page.
Choose a template.
Click Submit.
The user is directed to the index.stml page.
Select an empty DynamicDiv on the page.
Select the news-repeater.tpl file located in the web files -> content -> news folder to insert it into the dynamic div.
Click Publish.
Step 5 – Creating a page to house the detail template
With the www -> news folder open, click Add Page.
Enter the Name (detail.stml), Title and Description of the page.
Choose a template.
Click Submit.
The user is directed to the detail.stml page.
Select an empty DynamicDiv on the page.
Select the news-detail.tpl file located in the web files -> content -> news folder to insert it into the dynamic div.
Click Publish.
Step 6 – Mapping the detail.stml page to the team module
Expand the web files -> managers -> News folders.
Open the News module.
Click Modify.
Expand the Website Properties accordion.
Click Browse next to the Detail Template textbox.
Select the detail.stml page located in the www -> news folder.
Click Browse next to the Detail Folder Location text box.
Select the folder (www ->news) that contains the detail.stml file.
Click Submit.
Step 7 – Adding an Entry
Expand the web files -> managers -> News folders.
Open the News module.
Click Add Entry.
Enter the Name.
Select a Status.
Populate the Content and Intro/Excerpt.
Upload a Featured Image.
Set the categories
Click Submit.
