janisto/yii-ycm

YCM - Yii Content Management module

Installs: 571

Dependents: 0

Stars: 35

Watchers: 12

Forks: 15

Open Issues: 3

Language: JavaScript

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.