Comment créer une base de connaissance avec Joomla 4?

La vue categories

Juste pour rappel, categories est la vue qui affiche toutes les catégories de notre base de connaissance.

Par défaut dans le dossier com_content / categories, vous avez deux fichiers:

• default.php et default_items.php.

• Ouvrez le fichier default_items.php dans l'éditeur.

• Copiez tout le code ci-dessous :

  <?php
  /**
   * @package     Joomla.Site
   * @subpackage  com_content
   *
   * @copyright   Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
   * @license     GNU General Public License version 2 or later; see LICENSE.txt
   */
  
  defined('_JEXEC') or die;
  
  use Joomla\CMS\HTML\HTMLHelper;
  use Joomla\CMS\Language\Text;
  use Joomla\CMS\Router\Route;
  use Joomla\Component\Content\Site\Helper\RouteHelper;
  
  if ($this->maxLevelcat != 0 && count($this->items[$this->parent->id]) > 0) :
  ?>
  	<div class="row com-content-categories__items">
  		<?php foreach ($this->items[$this->parent->id] as $id => $item) : ?>
  		 
            <div class="col-lg-4 col-sm-12">	
            <?php if ($this->params->get('show_empty_categories_cat') || $item->numitems || count($item->getChildren())) : ?>
  			
              <div class="p-3 m-3 com-content-categories__item">
  				
              	<h3 class="page-header item-title">
  					<i class="bleu fas fa-folder mr-1"></i><a class="bleu" href="<?php echo Route::_(RouteHelper::getCategoryRoute($item->id, $item->language)); ?>">
  					<?php echo $this->escape($item->title); ?></a>
  					<?php if ($this->params->get('show_cat_num_articles_cat') == 1) :?>
  						<!--<span class="badge badge-info">
  							<?php echo Text::_('COM_CONTENT_NUM_ITEMS'); ?>&nbsp;
  							<?php echo $item->numitems; ?>
  						</span>-->
                          <br /><span class="nombre-articles">
                        	<?php echo $item->numitems; ?>
                          <?php echo JText::_('COM_CONTENT_NUM_ITEMS'); ?>&nbsp;
  					</span>
  					<?php endif; ?>
  					<?php if (count($item->getChildren()) > 0 && $this->maxLevelcat > 1) : ?>
  						<button
  							type="button"
  							id="category-btn-<?php echo $item->id; ?>"
  							data-target="#category-<?php echo $item->id; ?>"
  							data-toggle="collapse"
  							class="btn btn-secondary btn-sm float-right"
  							aria-label="<?php echo Text::_('JGLOBAL_EXPAND_CATEGORIES'); ?>"
  						>
  							<span class="fas fa-plus" aria-hidden="true"></span>
  						</button>
  					<?php endif; ?>
  				</h3>
  				<?php if ($this->params->get('show_description_image') && $item->getParams()->get('image')) : ?>
  					<img src="<?php echo $item->getParams()->get('image'); ?>" alt="<?php echo htmlspecialchars($item->getParams()->get('image_alt'), ENT_COMPAT, 'UTF-8'); ?>">
  				<?php endif; ?>
  				<?php if ($this->params->get('show_subcat_desc_cat') == 1) : ?>
  					<?php if ($item->description) : ?>
  						<div class="com-content-categories__description category-desc">
  							<?php echo HTMLHelper::_('content.prepare', $item->description, '', 'com_content.categories'); ?>
  						</div>
  					<?php endif; ?>
  				<?php endif; ?>
  
  				<?php if (count($item->getChildren()) > 0 && $this->maxLevelcat > 1) : ?>
  					<div class="com-content-categories__children collapse fade" id="category-<?php echo $item->id; ?>">
  					<?php
  					$this->items[$item->id] = $item->getChildren();
  					$this->parent = $item;
  					$this->maxLevelcat--;
  					echo $this->loadTemplate('items');
  					$this->parent = $item->getParent();
  					$this->maxLevelcat++;
  					?>
  					</div>
  				<?php endif; ?>
  			</div>
  			<?php endif; ?>
              </div>
  		<?php endforeach; ?>
  	</div>
  <?php endif; ?>

• et copiez le dans le fichier default_items.php.

• Lorsque vous avez terminé, cliquez sur le bouton Enregistrer et fermer.

Explications. Dans cet exemple, j'ai ajouté quelques classes CSS Bootstrap CSS classes pour afficher 3 categories par ligne (ligne 22), un peu de padding aet de margin (lidne 25) ainsi qu'une icône bleue juste devant le titre de chaque catégorie (ligne 28). Naturellement, vous pouvez conservez ces modifications ou les adapter au design de votre site.

La vue category

Juste pour rappel, la vue category est celle où tous les articles d'une catégorie de votre base de connaissance sont affichés.

Par défaut dans le dossier com_content / category, vous avez 7 fichiers :

• Pour votre information, les fichiers Default presentent les articles dans un tableeau. Donc, nous ne modifierons que les fichiers Blog pour afficher notre base de connaissance. Copiez chaque code ci-dessous et copiez les dans leurs fichiers respectifs (com_content / category / ...).

• le fichier blog.php

  <?php
  /**
   * @package     Joomla.Site
   * @subpackage  com_content
   *
   * @copyright   Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
   * @license     GNU General Public License version 2 or later; see LICENSE.txt
   */
  
  defined('_JEXEC') or die;
  
  use Joomla\CMS\Factory;
  use Joomla\CMS\HTML\HTMLHelper;
  use Joomla\CMS\Language\Text;
  use Joomla\CMS\Layout\FileLayout;
  
  $app = Factory::getApplication();
  
  $this->category->text = $this->category->description;
  $app->triggerEvent('onContentPrepare', array($this->category->extension . '.categories', &$this->category, &$this->params, 0));
  $this->category->description = $this->category->text;
  
  $results = $app->triggerEvent('onContentAfterTitle', array($this->category->extension . '.categories', &$this->category, &$this->params, 0));
  $afterDisplayTitle = trim(implode("\n", $results));
  
  $results = $app->triggerEvent('onContentBeforeDisplay', array($this->category->extension . '.categories', &$this->category, &$this->params, 0));
  $beforeDisplayContent = trim(implode("\n", $results));
  
  $results = $app->triggerEvent('onContentAfterDisplay', array($this->category->extension . '.categories', &$this->category, &$this->params, 0));
  $afterDisplayContent = trim(implode("\n", $results));
  
  ?>
  <div class="p-4 com-content-category-blog blog" itemscope itemtype="https://schema.org/Blog">
  	<?php if ($this->params->get('show_page_heading')) : ?>
  		<div class="page-header">
  			<h1><?php echo $this->escape($this->params->get('page_heading')); ?> </h1>
  		</div>
  	<?php endif; ?>
  
  	<?php if ($this->params->get('show_category_title', 1) or $this->params->get('page_subheading')) : ?>
  		<h2 class="bleu"> <?php echo $this->escape($this->params->get('page_subheading')); ?>
  			<?php if ($this->params->get('show_category_title')) : ?>
  				<span class="subheading-category"><i class="fas fa-book-open mr-2"></i><?php echo $this->category->title; ?></span>
  			<?php endif; ?>
  		</h2>
  	<?php endif; ?>
  	<?php echo $afterDisplayTitle; ?>
  
  	<?php if ($this->params->get('show_cat_tags', 1) && !empty($this->category->tags->itemTags)) : ?>
  		<?php $this->category->tagLayout = new FileLayout('joomla.content.tags'); ?>
  		<?php echo $this->category->tagLayout->render($this->category->tags->itemTags); ?>
  	<?php endif; ?>
  
  	<?php if ($beforeDisplayContent || $afterDisplayContent || $this->params->get('show_description', 1) || $this->params->def('show_description_image', 1)) : ?>
  		<div class="category-desc clearfix">
  			<?php if ($this->params->get('show_description_image') && $this->category->getParams()->get('image')) : ?>
  				<img src="<?php echo $this->category->getParams()->get('image'); ?>" alt="<?php echo htmlspecialchars($this->category->getParams()->get('image_alt'), ENT_COMPAT, 'UTF-8'); ?>">
  			<?php endif; ?>
  			<?php echo $beforeDisplayContent; ?>
  			<?php if ($this->params->get('show_description') && $this->category->description) : ?>
  				<?php echo HTMLHelper::_('content.prepare', $this->category->description, '', 'com_content.category'); ?>
  			<?php endif; ?>
  			<?php echo $afterDisplayContent; ?>
  		</div><hr>
  	<?php endif; ?>
  
  	<?php if (empty($this->lead_items) && empty($this->link_items) && empty($this->intro_items)) : ?>
  		<?php if ($this->params->get('show_no_articles', 1)) : ?>
  			<p><?php echo Text::_('COM_CONTENT_NO_ARTICLES'); ?></p>
  		<?php endif; ?>
  	<?php endif; ?>
  
  	<?php $leadingcount = 0; ?>
  	<?php if (!empty($this->lead_items)) : ?>
  		<div class="com-content-category-blog__items blog-items items-leading <?php echo $this->params->get('blog_class_leading'); ?>">
  			<?php foreach ($this->lead_items as &$item) : ?>
     				<div class="pl-2 py-4 com-content-category-blog__item blog-item"
  					itemprop="blogPost" itemscope itemtype="https://schema.org/BlogPosting">
                			<?php
  						$this->item = & $item;
  						echo $this->loadTemplate('item');
  						?>                      
  				</div><br />
        
  				<?php $leadingcount++; ?>
  			<?php endforeach; ?>
  		</div>
  	<?php endif; ?>
  
  	<?php
  	$introcount = count($this->intro_items);
  	$counter = 0;
  	?>
  
  	<?php if (!empty($this->intro_items)) : ?>
  		<div class="list-group list-group-flush com-content-category-blog__items blog-items <?php echo $this->params->get('blog_class'); ?>">
  		<?php foreach ($this->intro_items as $key => &$item) : ?>
  			<div class="p-4 list-group-item com-content-category-blog__item blog-item"
  				itemprop="blogPost" itemscope itemtype="https://schema.org/BlogPosting">
  					<?php
  					$this->item = & $item;
  					echo $this->loadTemplate('item');
  					?>
  			</div>
  		<?php endforeach; ?>
  		</div>
  	<?php endif; ?>
  
  	<?php if (!empty($this->link_items)) : ?>
  		<div class="com-content-category-blog__items-more items-more">
  			<?php echo $this->loadTemplate('links'); ?>
  		</div>
  	<?php endif; ?>
  
  	<?php if ($this->maxLevel != 0 && !empty($this->children[$this->category->id])) : ?>
  		<div class="com-content-category-blog__children cat-children">
  			<?php if ($this->params->get('show_category_heading_title_text', 1) == 1) : ?>
  				<h3> <?php echo Text::_('JGLOBAL_SUBCATEGORIES'); ?> </h3>
  			<?php endif; ?>
  			<?php echo $this->loadTemplate('children'); ?> </div>
  	<?php endif; ?>
  	<?php if (($this->params->def('show_pagination', 1) == 1 || ($this->params->get('show_pagination') == 2)) && ($this->pagination->pagesTotal > 1)) : ?>
  		<div class="com-content-category-blog__navigation w-100">
  			<?php if ($this->params->def('show_pagination_results', 1)) : ?>
  				<p class="com-content-category-blog__counter counter float-right pt-3 pr-2">
  					<?php echo $this->pagination->getPagesCounter(); ?>
  				</p>
  			<?php endif; ?>
  			<div class="com-content-category-blog__pagination">
  				<?php echo $this->pagination->getPagesLinks(); ?>
  			</div>
  		</div>
  	<?php endif; ?>
  </div>

Explications. Ici, j'ai ajouté un peu de padding (lignes 33 et 77), une classe pour afficher le texte en bleu (ligne 41) ainsiq u'une icône juste devant le titre de la catégorie (ligne 43). J'ai aussi ajouté quelques classes CSS Bootstrap CSS à la liste des articles (lignes 96 et 98). Là aussi, vous pouvez conserver ces modifications ou les adapter en fonction du design de votre site.

• Le fichier blog_children.php

  <?php
  /**
   * @package     Joomla.Site
   * @subpackage  com_content
   *
   * @copyright   Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
   * @license     GNU General Public License version 2 or later; see LICENSE.txt
   */
  
  defined('_JEXEC') or die;
  
  use Joomla\CMS\Factory;
  use Joomla\CMS\HTML\HTMLHelper;
  use Joomla\CMS\Language\Text;
  use Joomla\CMS\Router\Route;
  use Joomla\Component\Content\Site\Helper\RouteHelper;
  
  $lang   = Factory::getLanguage();
  $user   = Factory::getUser();
  $groups = $user->getAuthorisedViewLevels();
  
  if ($this->maxLevel != 0 && count($this->children[$this->category->id]) > 0) : ?>
  
  	<?php foreach ($this->children[$this->category->id] as $id => $child) : ?>
  		<?php // Check whether category access level allows access to subcategories. ?>
  		<?php if (in_array($child->access, $groups)) : ?>
  			<?php if ($this->params->get('show_empty_categories') || $child->numitems || count($child->getChildren())) : ?>
  			<div class="com-content-category-blog__child">
  				<?php if ($lang->isRtl()) : ?>
  				<h3 class="page-header item-title">
  					<?php if ( $this->params->get('show_cat_num_articles', 1)) : ?>
  						<span class="badge badge-info tip">
  							<?php echo $child->getNumItems(true); ?>
  						</span>
  					<?php endif; ?>
  					<a href="<?php echo Route::_(RouteHelper::getCategoryRoute($child->id, $child->language)); ?>">
  					<?php echo $this->escape($child->title); ?></a>
  
  					<?php if ($this->maxLevel > 1 && count($child->getChildren()) > 0) : ?>
  						<a href="#category-<?php echo $child->id; ?>" data-toggle="collapse" data-toggle="button" class="btn btn-sm float-right" aria-label="<?php echo Text::_('JGLOBAL_EXPAND_CATEGORIES'); ?>"><span class="fas fa-plus" aria-hidden="true"></span></a>
  					<?php endif; ?>
  				</h3>
  				<?php else : ?>
  				<h3 class="page-header item-title"><a href="<?php echo Route::_(RouteHelper::getCategoryRoute($child->id, $child->language)); ?>">
  					<?php echo $this->escape($child->title); ?></a>
  					<?php if ( $this->params->get('show_cat_num_articles', 1)) : ?>
  						<span class="badge badge-info">
  							<?php echo Text::_('COM_CONTENT_NUM_ITEMS'); ?>&nbsp;
  							<?php echo $child->getNumItems(true); ?>
  						</span>
  					<?php endif; ?>
  
  					<?php if ($this->maxLevel > 1 && count($child->getChildren()) > 0) : ?>
  						<a href="#category-<?php echo $child->id; ?>" data-toggle="collapse" data-toggle="button" class="btn btn-sm float-right" aria-label="<?php echo Text::_('JGLOBAL_EXPAND_CATEGORIES'); ?>"><span class="fas fa-plus" aria-hidden="true"></span></a>
  					<?php endif; ?>
  				</h3>
  				<?php endif; ?>
  
  				<?php if ($this->params->get('show_subcat_desc') == 1) : ?>
  				<?php if ($child->description) : ?>
  					<div class="com-content-category-blog__description category-desc">
  						<?php echo HTMLHelper::_('content.prepare', $child->description, '', 'com_content.category'); ?>
  					</div>
  				<?php endif; ?>
  				<?php endif; ?>
  
  				<?php if ($this->maxLevel > 1 && count($child->getChildren()) > 0) : ?>
  				<div class="com-content-category-blog__children collapse fade" id="category-<?php echo $child->id; ?>">
  					<?php
  					$this->children[$child->id] = $child->getChildren();
  					$this->category = $child;
  					$this->maxLevel--;
  					echo $this->loadTemplate('children');
  					$this->category = $child->getParent();
  					$this->maxLevel++;
  					?>
  				</div>
  				<?php endif; ?>
  			</div>
  			<?php endif; ?>
  		<?php endif; ?>
  	<?php endforeach; ?>
  <?php endif;

• Le fichier blog_item.php

  <?php
  /**
   * @package     Joomla.Site
   * @subpackage  com_content
   *
   * @copyright   Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
   * @license     GNU General Public License version 2 or later; see LICENSE.txt
   */
  
  defined('_JEXEC') or die;
  
  use Joomla\CMS\Factory;
  use Joomla\CMS\Language\Associations;
  use Joomla\CMS\Layout\LayoutHelper;
  use Joomla\CMS\Router\Route;
  use Joomla\CMS\Uri\Uri;
  use Joomla\Component\Content\Administrator\Extension\ContentComponent;
  use Joomla\Component\Content\Site\Helper\RouteHelper;
  
  // Create a shortcut for params.
  $params = $this->item->params;
  $canEdit = $this->item->params->get('access-edit');
  $info    = $params->get('info_block_position', 0);
  
  // Check if associations are implemented. If they are, define the parameter.
  $assocParam = (Associations::isEnabled() && $params->get('show_associations'));
  
  ?>
  
  <?php echo LayoutHelper::render('joomla.content.intro_image', $this->item); ?>
  
  <div class="item-content">
  	<?php if ($this->item->stage_condition == ContentComponent::CONDITION_UNPUBLISHED || strtotime($this->item->publish_up) > strtotime(Factory::getDate())
  		|| (!is_null($this->item->publish_down) && strtotime($this->item->publish_down) < strtotime(Factory::getDate()))) : ?>
  		<div class="system-unpublished">
  	<?php endif; ?>
  
  	<?php echo LayoutHelper::render('joomla.content.blog_style_default_item_title', $this->item); ?>
  
  	<?php if ($canEdit) : ?>
  		<?php echo LayoutHelper::render('joomla.content.icons', array('params' => $params, 'item' => $this->item)); ?>
  	<?php endif; ?>
  
  	<?php // Todo Not that elegant would be nice to group the params ?>
  	<?php $useDefList = ($params->get('show_modify_date') || $params->get('show_publish_date') || $params->get('show_create_date')
  		|| $params->get('show_hits') || $params->get('show_category') || $params->get('show_parent_category') || $params->get('show_author') || $assocParam); ?>
  
  	<?php if ($useDefList && ($info == 0 || $info == 2)) : ?>
  		<?php echo LayoutHelper::render('joomla.content.info_block', array('item' => $this->item, 'params' => $params, 'position' => 'above')); ?>
  	<?php endif; ?>
  	<?php if ($info == 0 && $params->get('show_tags', 1) && !empty($this->item->tags->itemTags)) : ?>
  		<?php echo LayoutHelper::render('joomla.content.tags', $this->item->tags->itemTags); ?>
  	<?php endif; ?>
  
  	<?php if (!$params->get('show_intro')) : ?>
  		<?php // Content is generated by content plugin event "onContentAfterTitle" ?>
  		<?php echo $this->item->event->afterDisplayTitle; ?>
  	<?php endif; ?>
  
  	<?php // Content is generated by content plugin event "onContentBeforeDisplay" ?>
  	<?php echo $this->item->event->beforeDisplayContent; ?>
  
  	<?php echo $this->item->introtext; ?>
  
  	<?php if ($info == 1 || $info == 2) : ?>
  		<?php if ($useDefList) : ?>
  			<?php echo LayoutHelper::render('joomla.content.info_block', array('item' => $this->item, 'params' => $params, 'position' => 'below')); ?>
  		<?php endif; ?>
  		<?php if ($params->get('show_tags', 1) && !empty($this->item->tags->itemTags)) : ?>
  			<?php echo LayoutHelper::render('joomla.content.tags', $this->item->tags->itemTags); ?>
  		<?php endif; ?>
  	<?php endif; ?>
  
  	<?php if ($params->get('show_readmore') && $this->item->readmore) :
  		if ($params->get('access-view')) :
  			$link = Route::_(RouteHelper::getArticleRoute($this->item->slug, $this->item->catid, $this->item->language));
  		else :
  			$menu = Factory::getApplication()->getMenu();
  			$active = $menu->getActive();
  			$itemId = $active->id;
  			$link = new Uri(Route::_('index.php?option=com_users&view=login&Itemid=' . $itemId, false));
  			$link->setVar('return', base64_encode(RouteHelper::getArticleRoute($this->item->slug, $this->item->catid, $this->item->language)));
  		endif; ?>
  
  		<?php echo LayoutHelper::render('joomla.content.readmore', array('item' => $this->item, 'params' => $params, 'link' => $link)); ?>
  
  	<?php endif; ?>
  
  	<?php if ($this->item->stage_condition == ContentComponent::CONDITION_UNPUBLISHED || strtotime($this->item->publish_up) > strtotime(Factory::getDate())
  		|| (!is_null($this->item->publish_down) && strtotime($this->item->publish_down) < strtotime(Factory::getDate()))) : ?>
  	</div>
  	<?php endif; ?>
  </div>
  
  <?php // Content is generated by content plugin event "onContentAfterDisplay" ?>
  <?php echo $this->item->event->afterDisplayContent; ?>

• Le fichier blog_links.php

  <?php
  /**
   * @package     Joomla.Site
   * @subpackage  com_content
   *
   * @copyright   Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
   * @license     GNU General Public License version 2 or later; see LICENSE.txt
   */
  
  defined('_JEXEC') or die;
  
  use Joomla\CMS\Router\Route;
  use Joomla\Component\Content\Site\Helper\RouteHelper;
  
  ?>
  
  <ol class="com-content-category-blog__links nav nav-tabs nav-stacked">
  	<?php foreach ($this->link_items as &$item) : ?>
  		<li class="com-content-category-blog__link">
  			<a href="<?php echo Route::_(RouteHelper::getArticleRoute($item->slug, $item->catid, $item->language)); ?>">
  				<?php echo $item->title; ?></a>
  		</li>
  	<?php endforeach; ?>
  </ol>

La vue Catégories

La vue Catégorie