README

Laravel的超级语言切换（SLS）包

超级语言切换（SLS）轻松地将多语言支持集成到Laravel中。它可以根据阿拉伯语和英语等语言调整网站布局，无缝地在RTL和LTR之间切换。

安装

1. 通过Composer安装

   您可以通过Composer安装此包。在您的项目目录中从终端运行此命令

   composer require i5z1a/super-language-switcher:dev-main

2. 注册服务提供者

   将超级语言切换服务提供者添加到您的 config/app.php 文件

   // config/app.php
   
   'providers' => [
       // Other service providers...
       I5z1a\SuperLanguageSwitcher\Providers\SuperLanguageSwitcherServiceProvider::class,
   ];

   注意：此步骤对于所有Laravel版本都是必需的，除了Laravel 11，因为Laravel 11不再需要手动服务提供者注册。

3. 发布配置（可选）

   如果需要自定义任何设置，则可选发布配置文件

   php artisan vendor:publish --provider="I5z1a\SuperLanguageSwitcher\Providers\SuperLanguageSwitcherServiceProvider"

4. 使用方法

   使用提供的 artisan 命令安装语言文件

   php artisan language-switcher:install

✅ 现在，Super Language Switcher（SLS）包已准备好用于您的项目！

前端

1. 语言选择列表

   将此列表添加到页眉或任何页面。

   <!-- Language Switch Menu -->
    <select id="languageSelect">
        <option value="ar">العربية</option>
        <option value="en">English</option>
    </select>

   在页眉或任何页面的页眉中包含JS代码（💡）提示：将JS代码包含在所有页面都可以访问的位置，例如网站页眉。

   <!-- Include JavaScript -->
   <script src="{{ asset('js/translations.js') }}"></script>

2. 翻译

   要添加翻译，您可以前往路径（public\lang）并查看JSON格式的语言文件，并且（SLS）包默认添加了阿拉伯语和英语。

   您还可以轻松地稍后添加不同的语言。通过这些语言文件，您可以添加页面内容的翻译，例如

   {
      "welcome_message": "اهلا بموقعنا",
      "about_us_link": "عنا",
      "contact_us_link": "تواصل",
    }

   然后添加英文文件

    {
        "welcome_message": "Welcome to our site!",
        "about_us_link": "About Us",
        "contact_us_link": "Contact Us",
    }

   请注意，我们在所有语言文件中使用了相同的键，以便在前端轻松显示它们

   如示例中所示

   <!-- Example placeholders -->
    <div data-translate="welcome_message"></div>
    <a class="translate-link" data-translate="about_us_link" href="#"></a>
    <a class="translate-link" data-translate="contact_us_link" href="/login"></a>

   通过 data-translate 我们可以输入翻译键来从JSON文件中显示文本。

✅ 现在，您的Laravel项目可以轻松地支持多种语言，而不需要任何路由。

由 @i5z1a 用爱心制作，以使开发者的生活更轻松 | 所有权利保留。