README.md

    TEEBB 0.x版本进入维护状态。即将重构代码,敬请期待。

    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有获利计划,我将优先通知您参与并获取相应利益。
    alt 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版本,仍有不少功能急需完善,暂将一些未实现功能按优先级列下,暂不公布时间线,我把其他工作做完就会完善的,表着急啊:)。

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

    6.TEEBB开源协议

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

    7.写在最后

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

    项目简介

    A content management system based on Symfony.

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/teebbstudios/teebb

    发行版本 11

    Symfony5.3版本支持

    全部发行版

    贡献者 3

    伟伟权 @qwwdezone
    D dependabot[bot] @dependabot[bot]

    开发语言

    • PHP 65.1 %
    • Shell 21.2 %
    • Twig 13.7 %