janisto/yii-ycm

YCM - Yii Content Management module

1.1.4 2014-12-05 12:56 UTC

README

YCM - Yii Content Management module

See examples for all the options.

Requirements

  • Yii 1.1.10 or above (Requires jQuery 1.7.1)

Installation

  • Download yii-ycm or clone the files to protected/modules/ycm
  • Edit Yii main configuration file protected/config/main.php. Enable module, set username, password and models you want to manage.
	'modules'=>array(
		...
		'ycm'=>array(
			'username'=>'YOUR USERNAME',
			'password'=>'YOUR PASSWORD',
			'registerModels'=>array(
				//'application.models.Blog', // one model
				'application.models.*', // all models in folder
			),
			'uploadCreate'=>true, // create upload folder automatically
			'redactorUpload'=>true, // enable Redactor image upload
		),
		...
	),

You can also use composer.

  • Require the package.
{
	"name": "app-name",
	"description": "App description",
	"type": "project",
	"prefer-stable": true,
	"require": {
		"php": ">=5.3.0",
		"yiisoft/yii": "1.1.14",
		"janisto/yii-ycm": "1.1.0",
	}
}
  • Add vendor path to your configuration file, enable module, set username, password and models you want to manage.
	'aliases'=>array(
		'vendor'=>realpath(__DIR__ . '/../../vendor'),
	),
	'modules'=>array(
		...
		'ycm'=>array(
			'class' =>'vendor.janisto.yii-ycm.YcmModule',
			'username'=>'YOUR USERNAME',
			'password'=>'YOUR PASSWORD',
			'registerModels'=>array(
				//'application.models.Blog', // one model
				'application.models.*', // all models in folder
			),
			'uploadCreate'=>true, // create upload folder automatically
			'redactorUpload'=>true, // enable Redactor image upload
		),
		...
	),
  • Add FileBehavior to your models if you are using file or image features. Add uploadPath and uploadUrl if you are not using the default uploads folder.
	...
	function behaviors() {
	    return array(
			'file' => array(
				'class'=>'application.modules.ycm.behaviors.FileBehavior',
				//'uploadPath'=>'/optional/path/to/uploads',
				//'uploadUrl'=>'http://optional.cdn.domain.com/uploads/path',
			),
	    );
	}
	...
  • FileBehavior methods:
$model = new Model;
echo $model->getFilePath('attribute');
echo $model->getFileUrl('attribute');
echo $model->getAbsoluteFileUrl('attribute');

Update

  • Clear assets folder.

Changelog

v1.1.4

  • Add Russian translation.

v1.1.3

  • Options to disable create, update and/or delete actions for a model.
  • Update libraries.
  • Fix: analytics setup forms with csrf validation.

v1.1.2

  • Improve FileBehavior
  • Update libraries.

v1.1.1

  • Fix time format.

v1.1.0

  • Add German translation.
  • Fix: behaviour class path.

v1.0.0

  • Fix: override options in all form widgets.
  • Add support for taggable behavior.
  • Add Chinese translation.
  • Update Finnish translation.
  • Improve Google Analytics statistics page.
  • Update libraries.
  • Update Composer support.

v0.5.0

  • Google Analytics statistics page.
  • Update yii-chosen to version v1.4.0
  • Update Redactor to 8.2.6
  • Composer support.
  • Fix: Better url & path handling.
  • Code cleanup.
  • Update Finnish translation.

v0.4.0

  • Update yii-chosen to version v1.1.0
  • Add first and last to pager.
  • Fix: allow auto login.

v0.3.0

  • Bootstrap typehead support.
  • Localization support and Finnish translation.
  • Fix: loadModel doesn't require PHP 5.3+ anymore.

v0.2.0

  • Initial version.

License

yii-ycm is free and unencumbered public domain software.