selenesoftware / cms-bundle

Symfony的CMS平台

0.0.11 2023-12-30 03:54 UTC

README

这是一个为Symfony Web框架的扩展包。因此,安装需要几个必要的步骤。首先,确保您系统上安装了Composer包管理器的最新版本。

安装

此扩展包可以在Symfony网站上启用CMS功能。这需要几个安装步骤,希望Symfony Flex已经处理了这些步骤,但以下是一些步骤。

如果您使用的是Symfony Flex(您应该这样做),只需在您的项目中运行以下Composer命令:bash composer require selenesoftware/cms-bundle 脚本将安装必要的控制器和配置,以便您可以开始使用。

如果您没有使用Flex,则需要添加以下行

// app/AppKernel.php
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            // ...
            new Selene\CMSBundle\seleneCMSBundle(),

        ];

        // ...

    }

}

然后您需要添加一些扩展了扩展包中控制器的控制器

BlogController extends Selene\CMSBundle\Controller\BlogController
SecurityController extends Selene\CMSBundle\Controller\SecurityController
RegistrationController extends Selene\CMSBundle\Controller\RegistrationController
AdminDashboardController extends Selene\CMSBundle\Controller\Admin\DashboardController

您需要为新网站创建几个模板。

templates/blog/index.html.twig
templates/security/login.html.twig
templates/registration/register.html.twig
templates/confirmation_email.html.twig

一旦安装了扩展包,运行您需要的数据库操作。

这将为您应用程序安装以下路由:/blog /blog/{entry} /register /login /admin

用法

当使用Twig扩展时,内容在后台管理。在首次加载时,块名称将出现在管理面板中,并允许更改标签内的数据。要创建标题为“selene”的内容块,请使用以下标签。

图像也有内容块。如果系统已上传图像,则会生成一个slug,该slug将加载该图像的URL。如果尚未上传图像,则将使用提供的URL作为默认值。

{% apply selene_content %}<div class="block">This is the default content in the block</div>{% endapply%}

<img srg="{% apply name_image %}image/url.jpg"{% endapply %}

这还安装了设置,它们是真/假或开/关。要使用其中之一,请使用以下标签

{% if getSetting('Search') %}<div class="search"><input type="text"></div>{% endif %}

默认情况下,设置是假的,所以第一次加载到网站上的内容将不会显示。

内容标签和设置标签的奇妙之处在于默认设置。您不需要在管理面板中创建它们即可创建一个。只需在您的Twig模板中编程它,首次渲染时它就会出现在您的管理面板中。从那里,您可以随意更改它们。并且如果您需要在不同的地方使用相同的内容,您也可以这样做。

贡献

欢迎提交pull请求。对于重大更改,请先提交一个问题来讨论您想要更改的内容。在创建新的功能分支时,运行`composer update`和`npm update`,并首先提交这些更改。

许可证

MIT