yii2 adminlte asset

حزمة أصول AdminLTE

واجهة المستخدم الخلفية لإطار عمل Yii2، استنادًا إلى AdminLTE

تحتوي هذه الحزمة على Asset Bundle لـ Yii 2.0 Framework الذي يسجل ملفات CSS لواجهة مستخدم AdminLTE.

يتم تثبيت ملفات CSS عبر استخدام Yii الموصى به للإصدار 1.1.1 من fxp/composer-asset-plugin أو الإصدارات الأحدث.

تثبيت

الطريقة المفضلة لتثبيت هذا الامتداد هي من خلال الملحن.

لتثبيت AdminLTE v2، قم بتشغيل:

 composer require dmstr/yii2-adminlte-asset "^2.1"

لتثبيت AdminLTE v1، قم بتشغيل:

 composer require dmstr/yii2-adminlte-asset "^1"

التعليمات

استخدام خط الويب

أسقط AdminLTE تضمين خط الويب في 2.4.0 ، لذلك تحتاج إلى تضمين الخط المطلوب يدويًا، على سبيل المثال.

 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,300italic,400italic,600italic">

لا يُنصح بالتضمين عبر CDN للإنتاج، برجاء تعديل ذلك ليناسب سير عمل تجميع الأصول لمشروعك.

لمزيد من التفاصيل انظر رقم 140.

الترقية

عند الترقية، يرجى مراجعة دليل ترقية AdminLTE للتعرف على التعديلات التي تحتاج إلى إجرائها في طرق العرض الخاصة بك.

تركيب الملحن

• بالنسبة للمشكلات المتعلقة بـ DmitryBaranovskiy/eve.git ، يرجى الاطلاع على #128 و#113.

مصفوفة التوافق

yii2-adminlte-asset	مشرفLTE	الخط رائع
2.4	2.0 - 2.3	مطلوب
2.5	2.4	مطلوب
3.0	2.4	-

بالنسبة للمشكلات الأخرى، يرجى البحث في GitHub أولاً.

بداية سريعة

بمجرد تثبيت الامتداد، يمكنك الحصول على معاينة عن طريق إعادة تكوين تعيينات المسار لمكون العرض:

لقالب التطبيق المتقدم Yii 2 أو قالب التطبيق الأساسي

 ' components ' => [
    ' view ' => [
         ' theme ' => [
             ' pathMap ' => [
                ' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app '
             ],
         ],
    ],
],

لتطبيق phd5

 ' components ' => [
    ' view ' => [
        ' theme ' => [
            ' pathMap ' => [
                ' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/testing/app '
            ],
        ],
    ],
],

توفر حزمة الأصول هذه ملفات نموذجية للتخطيط والعرض (راجع examples/ )، وليس المقصود منها تخصيصها مباشرة في vendor/ المجلد .

لذلك يوصى بنسخ طرق العرض إلى تطبيقك وتعديلها وفقًا لاحتياجاتك.

التخصيص

• انسخ الملفات من vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app (أو سمة أخرى) إلى @app/views .
• قم بإزالة تكوين view المخصص من التطبيق الخاص بك عن طريق حذف تعيينات المسار، إذا قمت بإنشائها من قبل.
• قم بتحرير مشاهداتك بالالتزام بعلامات HTML vendor/almasaeed2010/adminlte/pages

الإضافات المشرفLTE

لا يتم تضمين أصول المكونات الإضافية لـ AdminLTE في AdminLteAsset ، ولكن يمكنك العثور على هذه الملفات في دليل البائع الخاص بك ضمن vendor/almasaeed2010/adminlte/plugins . لذا، إذا كنت تريد استخدام أي منها، نوصي بإنشاء حزمة مخصصة حيث تقوم بإدراج ملفات المكونات الإضافية التي تحتاجها:

 use yii  web  AssetBundle ;
class AdminLtePluginAsset extends AssetBundle
{
    public $ sourcePath = ' @vendor/almasaeed2010/adminlte/plugins ' ;
    public $ css = [
        ' chart.js/Chart.min.css ' ,
        // more plugin CSS here
    ];
    public $ js = [
        ' chart.js/Chart.bundle.min.js '
        // more plugin Js here
    ];
    public $ depends = [
        ' dmstradminltewebAdminLteAsset ' ,
    ];
}

نظرًا لأن هذا الأصل يعتمد على AdminLteAsset الخاص بنا، فهو الأصل الوحيد الذي يتعين عليك تسجيله، على سبيل المثال في ملف التخطيط main.php الخاص بك.

رأس محتوى مخصص

إذا كنت تريد استخدام DOM الأصلي للرؤوس AdminLTE

 < h1 >
    About < small > static page </ small >
</ h1 >

ثم يمكنك اتباع الكود:

 /* @var yiiwebView $this */

$ this -> params [ ' breadcrumbs ' ][] = ' About ' ;

$ this -> beginBlock ( ' content-header ' ); ?>
About <small>static page</small>
<?php $ this -> endBlock (); ?>

<div class="site-about">
    <p> This is the About page. You may modify the following file to customize its content: </p>
    <code> <?= __FILE__ ?> </code>
</div>

قائمة الشريط الجانبي الأيسر - قائمة الأدوات

إذا كنت بحاجة إلى فصل أقسام القائمة، فما عليك سوى إضافة خيار header إلى العنصر في items

    ' items ' => [
        [ ' label ' => ' Gii ' , ' iconType ' => ' far ' 'icon' => 'file-code', ' url ' => [ ' /gii ' ]],
        [ ' label ' => ' Debug ' , ' icon ' => ' dashboard-alt ' , ' url ' => [ ' /debug ' ]],
        [ ' label ' => ' MAIN NAVIGATION ' , ' header ' => true ], // here
        // ... a group items
        [ ' label ' => '' , ' header ' => true ],
        // ... a group items
        [ ' label ' => '' , ' header ' => true ],
        // ... a group items

لإضافة شارة لعنصر ما:

 ' items ' => [
    [
        ' label ' => ' Mailbox ' ,
        ' iconType ' => ' far ' ,
        ' icon ' => ' envelope ' ,
        ' url ' => [ ' /mailbox ' ],
        ' badge ' => ' <span class="badge badge-info right">123</span> '
    ],
]

افتراضيًا، ستتم إضافة بادئة Font Awesome إلى الأيقونات

قالب لمولد Gii CRUD

أخبر Gii عن القالب الخاص بنا. يتم الإعداد في ملف التكوين:

 if ( YII_ENV_DEV ) {
    $ config [ ' modules ' ][ ' gii ' ] = [
        ' class ' => ' yiigiiModule ' ,
        ' generators ' => [ // HERE
            ' crud ' => [
                ' class ' => ' yiigiigeneratorscrudGenerator ' ,
                ' templates ' => [
                    ' adminlte ' => ' @vendor/dmstr/yii2-adminlte-asset/gii/templates/crud/simple ' ,
                ]
            ]
        ],
    ];
}

اختبار

انتقل إلى مجلد الاختبارات وابدأ مكدس الاختبار

 cd tests
docker-compose up -d

قم بتثبيت yii2-adminlte-asset في تطبيق الاختبار

 docker-compose exec php composer install

افتح عناوين URL للاختبار في متصفحك

 http://docker.local:20580/test
http://docker.local:20580/test/login    

مزيد من المعلومات

للحصول على وثائق AdminLTE، يرجى قراءة https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html

تتبع قواعد تباعد الأسماء هيكل إطار عمل Yii 2.0، على سبيل المثال. dmstradminlteweb لحزمة الأصول.