Skip to content

A really simple plugin that allows you to manage and display blocks of content

License

Notifications You must be signed in to change notification settings

ciricihq/cake-blocks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CakePHP Blocks Plugin

Build Status Coverage Total Downloads License

A really simple plugin that allows you to manage and show small content blocks.

Install

Using Composer:

composer require ciricihq/blocks

You then need to load the plugin. You can use the shell command:

bin/cake plugin load Cirici/Blocks

or by manually adding statement shown below to your app's config/bootstrap.php:

Plugin::load('Cirici/Blocks');

Usage

There's a Trait that does all the job, and we've created a BlockHelper and a BlockComponent so you can use them easily on your CakePHP app.

To start using them, just load whatever class you want.

For the BlockHelper, on your AppView's initialize method, add:

// src/View/AppView.php
public function initialize()
{
    $this->loadHelper('Cirici/Blocks.Block');
}

For the BlockComponent, on your AppController's initialize:

// src/Controller/AppController.php
public function initialize()
{
    $this->loadComponent('Cirici/Blocks.Block');
}

Methods

Right now there are just two methods available (as said, this plugin is really simple):

  • get: retrieves the entire Block entity by its slug.
  • getContents: just returns the Block's content field contents.

Patches & Features

  • Fork
  • Mod, fix
  • Test - this is important, so it's not unintentionally broken
  • Commit - do not mess with license, todo, version, etc. (if you do change any, bump them into commits of their own that I can ignore when I pull)
  • Pull request - bonus point for topic branches

Bugs & Feedback

http://github.com/ciricihq/cake-blocks/issues

License

Copyright (c) 2016, Cirici New Media and licensed under GNU GPL3 license.