README

用于在Yii2网站上创建、管理和删除文章的Yii2扩展包。

创建、编辑和删除文章
包含附件、图片、相册、点击量的文章
管理类别和子类别
高级访问权限
审批
多语言支持
额外字段管理
SEO优化

安装

通过 composer 安装此扩展是首选方式。

运行以下命令之一

$ php composer.phar require vladkukushkin/yii2-articles "*"

或添加

"vladkukushkin/yii2-articles": "*"

配置

1. 图片文件夹

将img文件夹复制到您的webroot

2. 更新yii2 articles数据库模式

确保您已正确配置db应用程序组件，并运行以下命令

$ php yii migrate/up --migrationPath=@vendor/vladkukushkin/yii2-articles/migrations

3. 设置配置文件

在配置文件的模块部分设置。'categoryImagePath'和'categoryImageURL'必须在同一文件夹中设置。'itemImagePath'和'itemImageURL'必须在同一文件夹中设置。在这种情况下，您将能够在文本中保存图片。这是vova07/imperavi-widget的要求。

'modules' => [ 

	// Module Articles
	'articles' => [
		'class' => 'vladkukushkin\articles\Articles',
		'userClass' => 'dektrium\user\models\User',
		
		// Select Languages allowed
		'languages' => [ 
			"it-IT" => "it-IT", 
			"en-GB" => "en-GB", 
			"ru-RU" => "ru-Ru" 
		],			
		
		// Select Editor: no-editor, imperavi
		'editor' => 'imperavi',
		
		// Select Path To Upload Category Image
        'categoryImagePath' => '@webroot/img/articles/categories/',
        // Select URL To Upload Category Image
        'categoryImageURL'  => '@web/img/articles/categories/',
        // Select Path To Upload Category Thumb
        'categoryThumbPath' => '@webroot/img/articles/categories/thumb/',
        // Select URL To Upload Category Image
        'categoryThumbURL'  => '@web/img/articles/categories/thumb/',

        // Select Path To Upload Item Image
        'itemImagePath' => '@webroot/img/articles/items/',
        // Select URL To Upload Item Image
        'itemImageURL'  => '@web/img/articles/items/',
        // Select Path To Upload Item Thumb
        'itemThumbPath' => '@webroot/img/articles/items/thumb/',
        // Select URL To Upload Item Thumb
        'itemThumbURL'  => '@web/img/articles/items/thumb/',
		
		// Select Path To Upload Attachments
        'attachPath' => '@webroot/attachments/',
		// Select URL To Upload Attachment
        'attachURL' => '@web/img/articles/items/',
		// Select Image Types allowed
		'attachType' => 'application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, .csv, .pdf, text/plain, .jpg, .jpeg, .gif, .png',
		
		// Select Image Name: categoryname, original, casual
		'imageNameType' => 'categoryname',
		// Select Image Types allowed
		'imageType'     => 'jpg,jpeg,gif,png',
		// Thumbnails Options
		'thumbOptions'  => [ 
			'small'  => ['quality' => 100, 'width' => 150, 'height' => 100],
			'medium' => ['quality' => 100, 'width' => 200, 'height' => 150],
			'large'  => ['quality' => 100, 'width' => 300, 'height' => 250],
			'extra'  => ['quality' => 100, 'width' => 400, 'height' => 350],
		],

        // Show Titles in the views
        'showTitles' => true,
	],	
	
	// Module Kartik-v Grid
	'gridview' =>  [
		'class' => '\kartik\grid\Module',
	],
	
	// Module Kartik-v Markdown Editor
	'markdown' => [
		'class' => 'kartik\markdown\Module',
	],

]

高级模板推荐配置

URL规则

'components' => [

        // Url Manager
        'urlManager' => [
            // Disable index.php
            'showScriptName' => false,
            // Disable r= routes
            'enablePrettyUrl' => true,
            // Disable site/ from the URL
            'rules' => [
                '<id:\d+>/<alias:[A-Za-z0-9 -_.]+>' => 'articles/categories/view',
                '<cat>/<id:\d+>/<alias:[A-Za-z0-9 -_.]+>' => 'articles/items/view',
            ],
        ],
    ],

用户认证

文章权限

类别权限

用户类型

迁移向数据库添加4种用户类型

管理员
- 可以创建类别
- 可以发布类别
- 可以删除类别
- 可以更新类别
- 可以索引类别
- 可以创建文章
- 可以发布所有文章
- 可以更新所有文章
- 可以删除所有文章
- 可以索引所有文章
- 可以查看所有文章
编辑者
- 可以创建类别
- 不能发布类别
- 不能删除类别
- 可以更新类别
- 可以索引类别
- 可以创建文章
- 可以发布自己的文章
- 可以更新所有文章
- 可以删除自己的文章
- 可以索引文章
- 可以查看所有文章
发布者
- 不能创建类别
- 不能发布类别
- 不能删除类别
- 不能更新类别
- 可以索引类别
- 可以创建文章
- 可以发布自己的文章
- 可以更新自己的文章
- 可以删除自己的文章
- 可以索引自己的文章
- 可以查看所有文章
作者
- 不能创建类别
- 不能发布类别
- 不能删除类别
- 不能更新类别
- 可以索引类别
- 可以创建文章
- 不能发布自己的文章
- 可以更新自己的文章
- 不能删除文章
- 不能索引文章
- 可以查看文章

链接

管理员面板：PathToApp/index.php?r=articles
具有美化URL的管理员面板：PathToApp/articles
类别：PathToApp/index.php?r=articles/categories
具有美化URL的类别：PathToApp/articles/categories
条目：PathToApp/index.php?r=articles/items
具有美化URL的条目：PathToApp/articles/items
附件：PathToApp/index.php?r=articles/attachments
具有美化URL的附件：PathToApp/articles/attachments

变更日志

版本 0.6.2 - 实现 Pull Request #6
版本 0.6.1 - 修复 #4 #5 并添加激活/停用按钮
版本 0.6.0 - 添加 URL 规则
版本 0.5.2 - 添加附件
版本 0.6.2 - 添加对类别和文章的访问
版本 0.5.0 - 更新文章索引、类别索引、重构RBAC函数
版本 0.4.1 - 更新RBAC函数
版本 0.4.0 - 添加第一个RBAC函数
版本 0.3.1 - 添加图片到类别视图
版本 0.3.0 - 拒绝未登录用户索引、创建、更新、删除；仅允许查看
版本 0.2.7 - 更新文章参数
版本 0.2.6 - 更新迁移
版本 0.2.5 - 更新资产依赖
版本 0.2.4 - 更新意大利翻译
版本 0.2.3 - 更新资产设置 articles.css 在 bootstrap 之后
版本 0.2.2 - 更新条目视图
版本 0.2.1 - 在条目中添加 video_type 字段并修复修改
版本 0.2.0 - 在条目中添加上传图片
版本 0.1.14 - 清理类别代码
版本 0.1.13 - 通用上传文件字段
版本 0.1.12 - 添加迁移示例
版本 0.1.11 - 修复类别中删除图片的问题
版本 0.1.10 - 添加管理员菜单
版本 0.1.9 - 添加附件文件
版本 0.1.8 - 重构类别上传图片
版本 0.1.7 - 修复 TinyMCE 问题
版本 0.1.6 - 在类别和项目添加 Imperavi Redactor 作为编辑器
版本 0.1.5 - 更新项目创建和修改时间
版本 0.1.4 - 在模块添加项目变量
版本 0.1.3 - 重构模块变量
版本 0.1.2 - 添加 Facebook 和 Twitter 项目视图
版本 0.1.1 - 在数据库中添加附件表
版本 0.1.0 - 重构项目
版本 0.0.7 - 为类别添加图片上传
版本 0.0.6 - 添加 Composer
版本 0.0.5 - 修复上传图片的问题
版本 0.0.4 - 添加来自其他包的编辑器 ckeditor, tinymce, markdown
版本 0.0.3 - 对类别视图进行各种修复和更新
版本 0.0.2 - 添加多语言支持 I18N
版本 0.0.1 - 初次发布

所需库

Yii2 Grid: https://github.com/kartik-v/yii2-grid
Yii2 Widget: https://github.com/kartik-v/yii2-widgets
Yii2 mPDF: https://github.com/kartik-v/yii2-mpdf
Yii2 Imperavi Redactor: https://github.com/vova07/yii2-imperavi-widget

vladkukushkin / yii2-articles

维护者

详细信息