clash82/ezplatform-website-switcher

为用户添加建议访问网站其他语言的选项。此包使用浏览器的默认语言进行重定向,以访问正确的站点。

v1.0.0 2017-01-02 13:54 UTC

This package is auto-updated.

Last update: 2024-09-15 11:14:13 UTC


README

SensioLabsInsight

使用此包,您可以建议用户访问您网站的其他语言版本。此包使用浏览器的默认语言进行重定向,以访问正确的站点。

screenshot

要求

  • Symfony v2.6 或更高版本
  • eZ Publish 5.4 / eZ Platform 1.x 或更高版本

安装

此包通过 Composer 提供,因此以下说明与其他开源 Symfony 包的安装类似。

在终端中运行以下命令,从您的 Symfony 安装根目录(选择最新版本)

composer require clash82/ezplatform-website-switcher

app/AppKernel.php 文件中启用该包

$bundles = array(
    // existing bundles
    new Clash82\EzPlatformWebsiteSwitcherBundle\Clash82EzPlatformWebsiteSwitcherBundle()
);

将外部资产添加到您的包中

  • CSS
bundles/clash82ezplatformwebsiteswitcher/css/website_switcher.css
components/flag-icon-css/css/flag-icon.min.css
  • JS
bundles/clash82ezplatformwebsiteswitcher/js/website_switcher.js

如果您通过 composer require 安装包,还必须将资产复制到项目的 web 目录中。您可以通过从项目根目录调用 Symfony 内置命令来完成此操作

php app/console assets:install --symlink

配置

以下是需要设置示例(config.yml)

ez_website_switcher:
    # name to be used to store banner status
    cookie_name: websiteSwitcherStatus

    # how many days banner should be hidden when user disables the banner?
    days: 365

支持的语言由您的 eZ Publish / eZ Platform 安装检测。

用法

在头部模板的 body 标签关闭后,插入以下 {{ show_website_switcher_banner() }} 辅助函数。

以下可选参数可以作为数组格式中的参数设置(覆盖默认设置和 config.yml 文件中的参数)

标准 eZ Publish / eZ Platform 应用程序的用法示例

{{ show_website_switcher_banner() }}

{{ show_website_switcher_banner({
   cookieName: 'myCookie',
   days: 7
}) }}