Installs: 752

Dependents: 0

Suggesters: 0

Security: 0

Stars: 3

Watchers: 7

Forks: 0

Open Issues: 0



v5.1.0 2024-02-13 05:27 UTC


This module brings a full category system to use in your websites and to administrate on the platform with fully multi lingual and multi sites functionalities

Getting started

These instructions will get you a copy of the project up and running on your machine.


The following modules need to be installed to have Melis cms category2 module run:

  • Melis core
  • Melis engine
  • Melis CMS


Run the composer command:

composer require melisplatform/melis-cms-category2


Database model is accessible via the MySQL Workbench file:


Database will be installed through composer and its hooks.
In case of problems, SQL files are located here:


Tools and elements provided

  • Category tool
  • Category Service
  • Category display plugin

Categories tool

Provides the user with the basic actions in managing categories such as:

  • Creation
    • user can create a category
  • Edition
    • user can manage the category titles, contents, dates of validity, or attach media(images, files).
  • Deletion
    • user can delete a category

MelisCmsCategory2 Services

MelisCmsCategory2 provides two services to be used in other modules. Find them in the folder : /melis-cms-category2/src/Service

File: /melis-cms-category2/src/Service/MelisCsmCategoryService.php
  • This service can be used inside other modules like so:
// Get the category service
$cmsCategorySvc = $this->getServiceManager()->get("MelisCmsCategory2Service");
// Get category tree
$result = $cmsCategorySvc->getCategoryTreeview($fatherId,$langId,$onlyValid, $siteId);
// Get the category data 
$categoryData = $cmsCategorySvc->getCategoryById($categoryId,$langId,$onlyValid);
  • Common methods this service is used for are as follows:
    • Category creation/edition: saveCategory(...)
    • Category site creation/edition: saveCategorySites(...)
    • Category translation creation/edition: saveCategoryTexts(...)
  • For a more detailed information on the methods, please visit the file.

Category display categories plugin

  • Use the plugin in a hardcoded way , in your controller :
* Generating category display using MelisCmsCategoryDisplayCategoriesPlugin Plugin
* (hardcoded)
$categoryDisplay = $this->MelisCmsCategoryDisplayCategoriesPlugin();
$categoryDisplayParameters = array(
    'template_path' => array('MelisCmsCategory2/default'),
    // Site id of News
    'site_id' => 1,
    'category_start' => 1,
// add generated view to children views for displaying it in the contact view
$this->view->addChild($categoryDisplay->render($categoryDisplayParameters), 'categoryDisplay');
  • In your view file :
<?php echo $this->categoryDisplay; ?>


See also the list of contributors who participated in this project.


This project is licensed under the Melis Technology premium versions end user license agreement (EULA) - see the file for details