PHP Classes

File: README.md

Recommend this page to a friend!
  Classes of Fabrice Fesch   Melis CMS   README.md   Download  
File: README.md
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: Melis CMS
Content management system that provides its tools
Author: By
Last change:
Date: 1 year ago
Size: 6,485 bytes
 

Contents

Class file image Download

melis-cms

MelisCms provides a full CMS for Melis Platform, including templating system, drag'n'drop of plugins, SEO and many administration tools.

Getting Started

These instructions will get you a copy of the project up and running on your machine. This Melis Platform module is made to work with the MelisCore.

Prerequisites

You will need to install melisplatform/melis-core and melisplatform/melis-engine in order to have this module running. This will automatically be done when using composer.

Installing

Run the composer command:

composer require melisplatform/melis-cms

Tools & Elements provided

  • Page Edition System (Edition, Properties, SEO, Languages)
  • Site Tool
  • Template Tool
  • Platform Ids Tool
  • Site Redirect Tool
  • Styles Tool
  • Page's Languages Tool
  • Dashboard Indicators
  • Site Tree View
  • Site Tree Explorer & Search
  • Melis Templating Plugins Components for back-office

Running the code

MelisCms Services

MelisCms provides many services to be used in other modules:

  • MelisCmsPageService  
    Services to save a page and to save its different parts (SEO, styles, languages, etc).  
    File: /melis-cms/src/Service/MelisCmsPageService.php  
    // Get the service
    $pageSrv = $this->getServiceManager()->get('MelisCmsPageService');  
    // Save a page and get its id back
    $pageId = $pageSrv->savePage($pageTree, $pagePublished, $pageSaved, $pageSeo, $pageLang, $pageStyle);  
    
  • MelisCmsSiteService  
    Save a site, get the list of pages of a site and many more.  
    File: /melis-cms/src/Service/MelisCmsSiteService.php  
    // Get the service
    $cmsSiteSrv = $this->getServiceManager()->get('MelisCmsSiteService');  
    // Get list of pages of this site
    $sitePages = $cmsSiteSrv->getSitePages($siteId);  
    
  • MelisCmsPageGetterService  
    Get the full HTML of a page. 
    This service works with the cache system. A page must have been generated at least one, so that the cache is generated and available to be used by the service.  
    Cache is generated in this folder: /cache  
    File: /melis-cms/src/Service/MelisCmsPageGetterService.php  
    // Get the service
    $pageGetterService = $this->getServiceManager()->get('MelisCmsPageGetterService');  
    // Get list of pages of this site
    $pageContent = $cmsSiteSrv->getPageContent($pageId);  
    
  • MelisCmsRightsService  
    Get the rights defined for the user and adapt access to the different elements of the interface:  
    File: /melis-cms/src/Service/MelisCmsRightsService.php    
    // Get the service  
    $melisCmsRights = $this->getServiceManager()->get('MelisCmsRights');  
    // Get the user's rights  
    $xmlRights = $melisCoreAuth->getAuthRights();  
    // find if a user has access to it
    // Example: find if a user has access to a specific page id
    $isAccessible = $melisCmsRights->isAccessible($xmlRights, MelisCmsRightsService::MELISCMS_PREFIX_PAGES, $idPage);          
    

MelisCms Forms

Forms factories

All Melis CMS forms are built using Form Factories. All form configuration are available in the file: /melis-cms/config/app.forms.php Any module can override or add items in this form by building the keys in an array and marge it in the Module.php config creation part.

return array(
	'plugins' => array(
	
		// MelisCms array
		'meliscms' => array(
		
			// Form key
			'forms' => array(
			
				// MelisCms Page Properties form
				'meliscms_page_properties' => array(
					'attributes' => array(
						'name' => 'pageproperties',
						'id' => 'idformpageproperties',
						'method' => 'POST',
						'action' => '/melis/MelisCms/Page/saveProperties',
					),
					'hydrator'  => 'Laminas\Hydrator\ArraySerializable',
					'elements' => array(  
						array(
							'spec' => array(
								...
							),
						),
					),
					'input_filter' => array(      
						'page_id' => array(
							...
						),   
					),
				),
			),
		),
	),
),

Forms elements

MelisCms provides many form elements to be used in forms: * MelisCmsTemplateSelect: a dropdown to select a template * MelisCmsPlatformSelect: a dropdown to select a platform * MelisCmsStyleSelect: a dropdown to select a style * MelisSwitch: an on-off button designed for Melis Platform * MelisCmsLanguageSelect: a dropdown to select the language * MelisCmsPageLanguagesSelect: a dropdown to select the page language * MelisMultiValInput: multiple input selection * MelisCmsPlatformIDsSelect: a dropdown to select the platform id * MelisCmsPluginSiteSelect: a dropdown to select the site * MelisCmsPluginSiteModuleSelect: a dropdown to select the module

Listening to services and update behavior with custom code

Most services trigger events so that the behavior can be modified.

public function attach(EventManagerInterface $events)
{
    $sharedEvents      = $events->getSharedManager();
    
    $callBackHandler = $sharedEvents->attach(
    	'MelisCms',
    	array(
    		'meliscms_page_save_start',
    		'meliscms_page_publish_start',
    	),
    	function($e){

    		$sm = $e->getTarget()->getEvent()->getApplication()->getServiceManager();
    		
    		// Custom Code here
    	},
    100);
    
    $this->listeners[] = $callBackHandler;
}

TinyMCE configurations

MelisCms brings 3 defaults configuration when editing a template within a "MelisTag" editable area: * html: full sets of buttons for the editor * textarea: buttons limited to text and links * media: buttons limited to media object insertion such as images and videos Creating other config is possible. Add the config in a file then declare the file in the module.config.php file of the module:

// Config Files  
'tinyMCE' => array(  
	'html' => 'MelisCms/public/js/tinyMCE/html.php',  
	'textarea' => 'MelisCms/public/js/tinyMCE/textarea.php',  
	'media' => 'MelisCms/public/js/tinyMCE/media.php',  
),  
  • mini templates will automatically turned into plugins if places in their folder.

Javascript helpers provided with MelisCms

  • melisLinkTree: Shows a modal with the treeview to search and make a page selection
    melisLinkTree.createInputTreeModal('#sourcePageId');  
    

Authors

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

License

This project is licensed under the OSL-3.0 License - see the LICENSE.md file for details