Articles Module (#43738)

Co-authored-by: Brian Teeman <brian@teeman.net>
Co-authored-by: Martina Scholz <martina@simplysmart-it.de>
Co-authored-by: Benjamin Trenkle <bembelimen@users.noreply.github.com>

administrator/components/com_admin/sql/updates/mysql/5.2.0-2024-07-02.sql

@@ -0,0 +1,3 @@
+-- Add mod_articles module
+INSERT INTO `#__extensions` (`package_id`, `name`, `type`, `element`, `folder`, `client_id`, `enabled`, `access`, `protected`, `locked`, `manifest_cache`, `params`, `custom_data`) VALUES
+(0, 'mod_articles', 'module', 'mod_articles', '', 0, 1, 0, 0, 1, '', '', '');

administrator/components/com_admin/sql/updates/postgresql/5.2.0-2024-07-02.sql

@@ -0,0 +1,3 @@
+-- Add mod_articles module
+INSERT INTO "#__extensions" ("package_id", "name", "type", "element", "folder", "client_id", "enabled", "access", "protected", "locked", "manifest_cache", "params", "custom_data", "ordering", "state") VALUES
+(0, 'mod_articles', 'module', 'mod_articles', '', 0, 1, 0, 0, 1, '', '', '', 0, 0);

build/media_source/mod_articles/css/mod-articles.css

@@ -0,0 +1,79 @@
+.mod-articles-item-card .mod-articles-link::before {
+  position: absolute;
+  z-index: 1;
+  content: "";
+  inset: 0;
+}
+.mod-articles-item-card {
+  position: relative;
+}
+.mod-articles-item-card:focus-within {
+  box-shadow: 0 0 0 var(--focus-ring-width) var(--focus-ring-color);
+}
+.mod-articles-item-card:focus-within :focus {
+  border: none;
+  outline: none;
+  box-shadow: none;
+}
+.mod-articles-item-card:hover {
+  box-shadow: 1px 1px 4px #0000001a;
+}
+.mod-articles-item {
+  display: flex;
+  flex-direction: column;
+}
+.mod-articles-item .mod-articles-item-content {
+  order: 1;
+}
+.mod-articles-image {
+  margin-bottom: .5rem;
+}
+@supports (container-type: inline-size) {
+  div:has(.mod-articles-grid),
+  section:has(.mod-articles-grid) {
+    container-type: inline-size;
+  }
+}
+.grid-cols-2 {
+  --grid-column-count: 2;
+}
+.grid-cols-3 {
+  --grid-column-count: 3;
+}
+.grid-cols-4 {
+  --grid-column-count: 4;
+}
+.mod-articles-grid {
+  --grid-layout-gap: 2rem;
+  --grid-item--min-width: 100px;
+  --gap-count: calc(var(--grid-column-count) - 1);
+  --total-gap-width: calc(var(--gap-count) * var(--grid-layout-gap));
+  --grid-item--max-width: calc((100% - var(--total-gap-width)) / var(--grid-column-count));
+
+  display: grid;
+  grid-template-columns: 1fr;
+  grid-gap: var(--grid-layout-gap);
+}
+@container (min-width: 768px) {
+  .mod-articles-grid {
+    grid-template-columns: 1fr 1fr;
+  }
+}
+@container (min-width: 992px) {
+  .mod-articles-grid {
+    grid-template-columns: repeat(auto-fill, minmax(max(var(--grid-item--min-width), var(--grid-item--max-width)), 1fr));
+  }
+}
+
+@supports not (container-type: inline-size) {
+  @media (min-width: 768px) {
+    .mod-articles-grid {
+      grid-template-columns: 1fr 1fr;
+    }
+  }
+  @media (min-width: 992px) {
+    .mod-articles-grid {
+      grid-template-columns: repeat(auto-fill, minmax(max(var(--grid-item--min-width), var(--grid-item--max-width)), 1fr));
+    }
+  }
+}

installation/sql/mysql/base.sql

@@ -222,7 +222,8 @@ INSERT INTO `#__extensions` (`package_id`, `name`, `type`, `element`, `folder`,
 (0, 'mod_articles_category', 'module', 'mod_articles_category', '', 0, 1, 1, 0, 1, '', '', ''),
 (0, 'mod_articles_categories', 'module', 'mod_articles_categories', '', 0, 1, 1, 0, 1, '', '', ''),
 (0, 'mod_languages', 'module', 'mod_languages', '', 0, 1, 1, 0, 1, '', '', ''),
-(0, 'mod_finder', 'module', 'mod_finder', '', 0, 1, 0, 0, 1, '', '', '');
+(0, 'mod_finder', 'module', 'mod_finder', '', 0, 1, 0, 0, 1, '', '', ''),
+(0, 'mod_articles', 'module', 'mod_articles', '', 0, 1, 0, 0, 1, '', '', '');
 
 -- Modules: Administrator
 INSERT INTO `#__extensions` (`package_id`, `name`, `type`, `element`, `folder`, `client_id`, `enabled`, `access`, `protected`, `locked`, `manifest_cache`, `params`, `custom_data`) VALUES

installation/sql/postgresql/base.sql

@@ -228,7 +228,8 @@ INSERT INTO "#__extensions" ("package_id", "name", "type", "element", "folder",
 (0, 'mod_articles_category', 'module', 'mod_articles_category', '', 0, 1, 1, 0, 1, '', '', '', 0, 0),
 (0, 'mod_articles_categories', 'module', 'mod_articles_categories', '', 0, 1, 1, 0, 1, '', '', '', 0, 0),
 (0, 'mod_languages', 'module', 'mod_languages', '', 0, 1, 1, 0, 1, '', '', '', 0, 0),
-(0, 'mod_finder', 'module', 'mod_finder', '', 0, 1, 0, 0, 1, '', '', '', 0, 0);
+(0, 'mod_finder', 'module', 'mod_finder', '', 0, 1, 0, 0, 1, '', '', '', 0, 0),
+(0, 'mod_articles', 'module', 'mod_articles', '', 0, 1, 0, 0, 1, '', '', '', 0, 0);
 
 -- Modules: Administrator
 INSERT INTO "#__extensions" ("package_id", "name", "type", "element", "folder", "client_id", "enabled", "access", "protected", "locked", "manifest_cache", "params", "custom_data", "ordering", "state") VALUES

language/en-GB/mod_articles.ini

@@ -0,0 +1,95 @@
+; Joomla! Project
+; (C) 2024 Open Source Matters, Inc. <https://www.joomla.org>
+; License GNU General Public License version 2 or later; see LICENSE.txt
+; Note : All ini files need to be saved as UTF-8
+
+MOD_ARTICLES="Articles"
+MOD_ARTICLES_FIELD_ARTICLEGROUPINGDIR_LABEL="Grouping Direction"
+MOD_ARTICLES_FIELD_ARTICLEGROUPING_LABEL="Article Grouping"
+MOD_ARTICLES_FIELD_ARTICLEORDERINGDIR_LABEL="Ordering Direction"
+MOD_ARTICLES_FIELD_ARTICLEORDERING_LABEL="Article Field to Order By"
+MOD_ARTICLES_FIELD_AUTHORALIASFILTERING_LABEL="Author Alias Filtering Type"
+MOD_ARTICLES_FIELD_AUTHORALIAS_LABEL="Author Aliases"
+MOD_ARTICLES_FIELD_AUTHORFILTERING_LABEL="Author Filtering Type"
+MOD_ARTICLES_FIELD_AUTHOR_LABEL="Authors"
+MOD_ARTICLES_FIELD_CATDEPTH_LABEL="Category Depth"
+MOD_ARTICLES_FIELD_CATFILTERINGTYPE_DESC="Include or exclude the selected categories."
+MOD_ARTICLES_FIELD_CATFILTERINGTYPE_LABEL="Category Filtering Type"
+MOD_ARTICLES_FIELD_COUNT_DESC="The number of items to display. The default value of 0 will display all articles."
+MOD_ARTICLES_FIELD_COUNT_LABEL="Articles to Display"
+MOD_ARTICLES_FIELD_DATEFIELDFORMAT_DESC="Please enter in a valid date format. See: https://php.net/date for formatting information."
+MOD_ARTICLES_FIELD_DATEFIELDFORMAT_LABEL="Date Format"
+MOD_ARTICLES_FIELD_DATEFIELD_LABEL="Date Field"
+MOD_ARTICLES_FIELD_DATEFILTERING_LABEL="Date Filtering"
+MOD_ARTICLES_FIELD_DATEGROUPINGFIELD_DESC="Select which date field you want the date grouping to be applied to."
+MOD_ARTICLES_FIELD_DATEGROUPINGFIELD_LABEL="Date Grouping Field"
+MOD_ARTICLES_FIELD_DATERANGEFIELD_LABEL="Date Range Field"
+MOD_ARTICLES_FIELD_ENDDATE_LABEL="To Date"
+MOD_ARTICLES_FIELD_EXCLUDEDARTICLES_LABEL="Article IDs to Exclude"
+MOD_ARTICLES_FIELD_EXCLUDE_CURRENT_LABEL="Exclude Current Article"
+MOD_ARTICLES_FIELD_GROUP_DISPLAY_LABEL="Display Options"
+MOD_ARTICLES_FIELD_GROUP_FILTERING_LABEL="Filtering Options"
+MOD_ARTICLES_FIELD_GROUP_GROUPING_LABEL="Grouping Options"
+MOD_ARTICLES_FIELD_GROUP_ORDERING_LABEL="Ordering Options"
+MOD_ARTICLES_FIELD_IMAGES_ARTICLE_LABEL="Show Intro/Full Image"
+MOD_ARTICLES_FIELD_IMAGES_DESC="Show the images that are inside the text of the article."
+MOD_ARTICLES_FIELD_IMAGES_LABEL="Show Article Images"
+MOD_ARTICLES_FIELD_INCLUDEDARTICLES_LABEL="Article IDs to Include"
+MOD_ARTICLES_FIELD_INFOLAYOUT_DESC="Layout for the Articles Info (Date, Hits, Category, Author)."
+MOD_ARTICLES_FIELD_INFOLAYOUT_LABEL="Articles Info Layout"
+MOD_ARTICLES_FIELD_INTROTEXTLIMIT_DESC="Truncate Introtext to a specified number of characters. Set to 0 to disable truncation."
+MOD_ARTICLES_FIELD_INTROTEXTLIMIT_LABEL="Introtext Limit (characters)"
+MOD_ARTICLES_FIELD_LAYOUT_COL_LABEL="Max. Number of Columns"
+MOD_ARTICLES_FIELD_LAYOUT_DESC="Vertical or horizontal display of articles."
+MOD_ARTICLES_FIELD_LAYOUT_HOR="Horizontal"
+MOD_ARTICLES_FIELD_LAYOUT_LABEL="Layout"
+MOD_ARTICLES_FIELD_LAYOUT_MULTILINE="Multiline"
+MOD_ARTICLES_FIELD_LAYOUT_SINGLELINE="Single Line"
+MOD_ARTICLES_FIELD_LAYOUT_VERT="Vertical"
+MOD_ARTICLES_FIELD_LINKTITLES_LABEL="Title Link"
+MOD_ARTICLES_FIELD_MONTHYEARFORMAT_DESC="Please enter in a valid date format. See: https://php.net/date for formatting information."
+MOD_ARTICLES_FIELD_MONTHYEARFORMAT_LABEL="Month and Year Display Format"
+MOD_ARTICLES_FIELD_ONLYARCHIVED_LABEL="Archived Articles"
+MOD_ARTICLES_FIELD_RELATIVEDATE_LABEL="Relative Date"
+MOD_ARTICLES_FIELD_SHOWCATEGORYLINK_LABEL="Category Link"
+MOD_ARTICLES_FIELD_SHOWCHILDCATEGORYARTICLES_DESC="Include or exclude articles in the child categories of the selected ones."
+MOD_ARTICLES_FIELD_SHOWCHILDCATEGORYARTICLES_LABEL="Child Category Articles"
+MOD_ARTICLES_FIELD_SHOWFEATURED_LABEL="Featured Articles"
+MOD_ARTICLES_FIELD_SHOWHITS_LABEL="Hits"
+MOD_ARTICLES_FIELD_SHOWINTROTEXT_LABEL="Introtext"
+MOD_ARTICLES_FIELD_STARTDATE_LABEL="Start Date Range"
+MOD_ARTICLES_FIELD_TITLEONLY_LABEL="Title Only (lists)"
+MOD_ARTICLES_FIELD_TITLE_HEADING="Header Level"
+MOD_ARTICLES_FIELD_TITLE_HEADING_NONE="None"
+MOD_ARTICLES_FIELD_TITLE_LABEL="Article Title"
+MOD_ARTICLES_INFO="Details"
+MOD_ARTICLES_OPTION_ASCENDING_VALUE="Ascending"
+MOD_ARTICLES_OPTION_CREATED_VALUE="Created Date"
+MOD_ARTICLES_OPTION_DATERANGE_VALUE="Date Range"
+MOD_ARTICLES_OPTION_DESCENDING_VALUE="Descending"
+MOD_ARTICLES_OPTION_EXCLUDE_VALUE="Exclude"
+MOD_ARTICLES_OPTION_EXCLUSIVE_VALUE="Exclusive"
+MOD_ARTICLES_OPTION_FINISHPUBLISHING_VALUE="Finish Publishing Date"
+MOD_ARTICLES_OPTION_FULLIMAGE="Full Image"
+MOD_ARTICLES_OPTION_HITS_VALUE="Hits"
+MOD_ARTICLES_OPTION_ID_VALUE="ID"
+MOD_ARTICLES_OPTION_INCLUDE_VALUE="Include"
+MOD_ARTICLES_OPTION_INCLUSIVE_VALUE="Inclusive"
+MOD_ARTICLES_OPTION_INTROIMAGE="Intro Image"
+MOD_ARTICLES_OPTION_MODIFIED_VALUE="Modified Date"
+MOD_ARTICLES_OPTION_MONTHYEAR_VALUE="Month and Year"
+MOD_ARTICLES_OPTION_NORMAL_VALUE="Normal"
+MOD_ARTICLES_OPTION_OFF_VALUE="Off"
+MOD_ARTICLES_OPTION_ONLYARCHIVEDHIDE_VALUE="None"
+MOD_ARTICLES_OPTION_ONLYARCHIVEDSHOW_VALUE="Only"
+MOD_ARTICLES_OPTION_ONLYFEATURED_VALUE="Only"
+MOD_ARTICLES_OPTION_ORDERINGFEATURED_VALUE="Featured Articles Order"
+MOD_ARTICLES_OPTION_ORDERING_VALUE="Article Order"
+MOD_ARTICLES_OPTION_RANDOM_VALUE="Random"
+MOD_ARTICLES_OPTION_RATING_VALUE="Rating"
+MOD_ARTICLES_OPTION_RELATIVEDAY_VALUE="Relative Date"
+MOD_ARTICLES_OPTION_STARTPUBLISHING_VALUE="Start Publishing Date"
+MOD_ARTICLES_OPTION_VOTE_VALUE="Vote"
+MOD_ARTICLES_OPTION_YEAR_VALUE="Year"
+MOD_ARTICLES_UNTAGGED="Untagged"
+MOD_ARTICLES_XML_DESCRIPTION="This module displays articles in a variety of ways."

language/en-GB/mod_articles.sys.ini

@@ -0,0 +1,8 @@
+; Joomla! Project
+; (C) 2024 Open Source Matters, Inc. <https://www.joomla.org>
+; License GNU General Public License version 2 or later; see LICENSE.txt
+; Note : All ini files need to be saved as UTF-8
+
+MOD_ARTICLES="Articles"
+MOD_ARTICLES_LAYOUT_DEFAULT="Default"
+MOD_ARTICLES_XML_DESCRIPTION="This module displays articles in a variety of ways."

libraries/src/Extension/ExtensionHelper.php

@@ -131,6 +131,7 @@ class ExtensionHelper
         ['module', 'mod_version', '', 1],
 
         // Core module extensions - site
+        ['module', 'mod_articles', '', 0],
         ['module', 'mod_articles_archive', '', 0],
         ['module', 'mod_articles_categories', '', 0],
         ['module', 'mod_articles_category', '', 0],