README

doctrine-bundle 2.3以上版本使用PhpArrayCache缓存ORM注解Metadata，会引起TEEBB在生产环境下重大BUG。

// 需要修改 doctrine-bundle 源码解决此问题
// vendor/doctrine/doctrine-bundle/DependencyInjection/DoctrineExtension.php
protected function loadOrmCacheDrivers(array $entityManager, ContainerBuilder $container)
{
    $this->loadCacheDriver('metadata_cache', $entityManager['name'], $entityManager['metadata_cache_driver'], $container);
    $this->loadCacheDriver('result_cache', $entityManager['name'], $entityManager['result_cache_driver'], $container);
    $this->loadCacheDriver('query_cache', $entityManager['name'], $entityManager['query_cache_driver'], $container);

    if ($container->getParameter('kernel.debug')) {
        return;
    }
    
    // 需要注释下面一行代码解决BUG
    // $this->registerMetadataPhpArrayCaching($entityManager['name'], $container);
}

TEEBB内容管理系统使用文档

TEEBB是基于Symfony框架开发的一款可自由扩展的内容管理系统。您可以自由使用本软件来构建您的博客、网站等应用。本项目将会长期开发维护，欢迎使用。
TEEBB的原理设计参考了著名的Drupal，注重内容的扩展性与功能性，因为Drupal的学习曲线太高了，于是我开发了TEEBB，它更轻量也更容易上手。目前0.x版本已实现了内容管理和一些基本功能，注重内容类型网站的开发。在后续版本中将实现I18N（国际化），RESTful API，消息队列，缓存等等功能。如果您是Symfony初学者，TEEBB用到了Symfony的多个组件，是个不错的学习案例。
欢迎您进行Fork，并提交Pull Request，我们一起开发维护TEEBB，如果后续TEEBB有获利计划，我将优先通知您参与并获取相应利益。

看 TEEBB基础视频教程

1.TEEBB的下载和安装说明

TEEBB的运行环境：
PHP 7.2.5及以上、Mysql 5.7.x、推荐安装：Symfony 命令行工具，详见：www.symfony.com

#下载TEEBB
composer create-project teebbstudios/teebb acme
cd acme
#安装JS库
npm install
gulp build
#安装CKEDITOR 资源包
symfony console ckeditor:install
#TEEBB资源安装
symfony console assets:install public --symlink
#复制.env文件到.env.local, 并修改数据库DATABASE_URL及MAILER_DSN信息
cp .env .env.local
#初始化数据库
symfony console teebb:database:init -d
#运行服务器
symfony serve
#打开页面登录管理页面
open http://127.0.0.1:8000/admin

初始管理员账号：admin
初始管理员密码：admin

2.TEEBB的版本号及开发周期说明

TEEBB的版本号遵循语义化版本格式：主版本号.次版本号.修订号
TEEBB的次版本号（例如：0.2.x，0.3.x）发布周期：至少每四个月发布一次。
TEEBB的修订版本号（例如：0.1.1，0.1.2）发布周期：至少每三个星期发布一次。

Tips:目前TEEBB 0.x版本的核心功能bundle仅包含在teebbstudios/core-bundle，并不利于后期维护，因此将在1.x版本重构TEEBB。

3.TEEBB的使用介绍

TEEBB的主题是内容管理，但是现实中各种各样不同类型的内容太多了，为了满足各种不同的需求以及实现灵活的扩展性，原理上我借鉴了国外的两个著名开源项目Drupal和Godot。
做个假设：

在另一个平行时空，我不是程序员而是一个名不见经传的在线小报记者，每天都忙于收集各种新闻，并发表在新闻网站上。我的新闻网站分为很多不同的栏目，有的栏目要求必须添加新闻图片及文字，有的栏目只用上传新闻文字，有的栏目只用上传新闻图片。
传统的内容管理系统是怎么做的呢?
它可能预先定义了一个统一的新闻格式，有标题、主体（Body）、封面图片等等所有可能用到的东西，然后我们创建对应的栏目分类词，再根据需要把新添加的新闻指定到对应的栏目中，这是一个好办法。但是我觉得这样灵活性及扩展性就不那么好了。
如果我们能把新闻中所用到的标题、主体（Body）、图片等等信息抽取成不同类型的组件（我把这种组件称为“字段”，后面都称为“字段”），然后将用到的字段组合成不同的内容类型，这样会在最大程度上实现灵活性及扩展性。
在TEEBB中，目前实现了内容、评论、分类、用户四种bundle包。这四种bundle的具体实现类型都可以组合不同的字段以实现不同的需求。

3.1 内容bundle
- 3.1.1 创建第一个内容类型
 3.2 字段
- 3.2.1 TEEBB内置的字段
- 3.2.2 TEEBB中常用字段的设置
 3.3 内容
- 3.3.1 添加内容
- 3.3.2 内容的查询（未实现，后续版本实现）
3.4 分类bundle
- 3.4.1 创建分类类型
- 3.4.2 分类类型中字段的设置
- 3.4.3 添加分类词汇
- 3.4.4 分类字段的使用
 3.5 评论bundle
- 3.5.1 创建评论类型
- 3.5.2 评论类型中字段的设置
- 3.5.3 评论字段的使用
- 3.5.4 管理评论内容
 3.6 用户与用户组
- 3.6.1 用户的概念
- 3.6.2 用户的字段管理（后续版本实现）
- 3.6.3 用户组及权限
 3.7 菜单系统
- 3.7.1 创建第一个菜单
- 3.7.2 菜单的显示
 3.8 常用Twig函数及全局变量(将会有视频教程讲解，敬请期待)

4.基于TEEBB的开发（将有免费视频教程，敬请期待）

TEEBB的设计就是要高扩展性，因此我们可以在TEEBB上进行二次开发。TEEBB默认提供了内容bundle、分类bundle、评论bundle、用户bundle。
如果有一天有个需求开发一个小型的在线商城。我们可以利用图像字段作为商品的图像信息，利用布尔值字段做为商品的上下架信息、全新或二手信息，利用小数字段为商品的价格信息等等。这样我们可以创建一个bundle作为SKU对象，再创建一个bundle做为商品对象并两者进行关联以实现商城功能。
不止商城，其他类型的应用也完全可以在TEEBB上进行二次开发。
Wooooo！这就是我对TEEBB的设想，如果我们基于TEEBB的二次开发能做些bundle产品并出售赚取一些利润，那就再好不过了。：）
4.1 创建自定义字段
- 4.1.1 FieldType注解介绍
- 4.1.2 实现注解中的所有的类
4.2 创建自定义bundle
- 4.2.1 EntityType注解介绍
- 4.2.2 实现EntityType中的所有类

Tips: 此节内容较多，文字无法完全表述，将有免费的视频教程推出。基于TEEBB的开发将以视频教程的形式发布在www.teebb.com上，敬请期待。

5.TEEBB的Roadmap

目前TEEBB发布了0.1.0版本，仍有不少功能急需完善，暂将一些未实现功能按优先级列下，暂不公布时间线，我把其他工作做完就会完善的，表着急啊：）。

ckeditor编辑器的图像上传。
控制台Topbar及内容列表搜索过滤。
用户字段的实现及前端分类内容字段的显示。
用户的字段管理。
缓存。
RESTful API, 使用api-platform开发。
格式化器及ckeditor编辑器在使用时联动的优化。
控制台Topbar面包屑功能。
bug修复。

6.TEEBB开源协议

本软件遵循MIT协议。如果您能在页面上注明您的应用使用了TEEBB，本人将万分感谢。：）

7.写在最后

本人可接Symfony开发的工作，正规公司资质，可开增值税发票，如有开发业务请与我联系。QQ/微信：443580003

teebbstudios / teebb

Maintainers

Details