Nous utilisons Yii2. Nous écrivons un autre CMS ou une tentative d'accélérer considérablement le développement avec un minimum de frais généraux

Presque chaque développeur qui travaille depuis longtemps avec un certain framework dispose d'un ensemble de ses propres outils qui permet d'accélérer le développement du site. Cependant, souvent, ils sont mal structurés, n'ont pas de documentation et sont finalisés dans le «processus» de production.

L'idée du projet yicms était de collecter tous les développements pour le framework Yii2, ce qui semblait commode dans un certain système, au premier rang desquels il faut mettre la facilité d'utilisation, la flexibilité et la capacité d'accélérer considérablement le développement de sites standards avec ses outils. Ce projet a été développé par moi pour "l'âme", mais pour le moment il est déjà en beta.

L'essence des yicms se situe quelque part entre les capacités du framework et les capacités habituelles du CMS. Ce n'est pas un CMS au sens habituel du terme, mais juste un ensemble de modules qui peuvent accélérer considérablement le développement du site à l'aide de ses outils, tout en ayant un «accès» complet aux capacités du framework. Les principales fonctionnalités intégrées dans yicms sont le panneau d'administration généré à la volée et les classes annotées automatiquement qui vous permettent d'utiliser la saisie semi-automatique IDE et d'avoir une interface intuitive.

Installation et configuration

Commençons donc par yicms en l'installant. Pour les rencontres, le moyen le plus simple consiste à utiliser Open Server ou toute autre plate-forme de serveur similaire. Étant donné que yicms dépend fortement de Yii, nous allons l'installer en premier. Pour plus de simplicité, nous utiliserons le modèle de base:

composer create-project --prefer-dist yiisoft/yii2-app-basic basic

Une fois que composer a installé le framework, ajoutez la section require du fichier composer.json avec les quatre modules yicms et exécutez la mise à jour de composer.

  "require": { "php": ">=5.4.0", "yiisoft/yii2": "~2.0.14", "yiisoft/yii2-bootstrap": "~2.0.0", "yiisoft/yii2-swiftmailer": "~2.0.0 || ~2.1.0", "iliich246/yii2-yicms-common": "dev-master", "iliich246/yii2-yicms-pages": "dev-master", "iliich246/yii2-yicms-essences": "dev-master", "iliich246/yii2-yicms-feedback": "dev-master" }, 

Chaque module représente un ensemble de fonctionnalités spécifiques, qui seront envisagées à l'avenir. Pour l'instant, installez-les tous.

Ensuite, vous devez vous rappeler de configurer le serveur. Dans Open Server, nous utilisons Apache et configurons .htaccess comme suit:

Pour le fichier racine .htaccess:

 Options +FollowSymLinks IndexIgnore */* RewriteEngine on RewriteCond %{REQUEST_URI} !^/(web) RewriteRule ^assets/(.*)$ /web/assets/$1 [L] RewriteRule ^css/(.*)$ web/css/$1 [L] RewriteRule ^js/(.*)$ web/js/$1 [L] RewriteRule ^images/(.*)$ web/images/$1 [L] RewriteRule ^files/(.*)$ web/files/$1 [L] RewriteRule (.*) /web/$1 RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . web/index.php 

Pour le fichier .htaccess dans le répertoire web

 RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . index.php 

L'étape suivante consiste à rouler la migration de chaque module yicms dans la base de données. Dans la console, nous exécutons séquentiellement les commandes suivantes:

yii migrate/up --migrationPath=@vendor/iliich246/yii2-yicms-common/Migrations

yii migrate/up --migrationPath=@vendor/iliich246/yii2-yicms-pages/Migrations

yii migrate/up --migrationPath=@vendor/iliich246/yii2-yicms-essences/Migrations

yii migrate/up --migrationPath=@vendor/iliich246/yii2-yicms-feedback/Migrations

Commençons maintenant la configuration dans le fichier config / web.php.

La section des modules est configurée comme suit:

 'modules' => [ 'common' => [ 'class' => 'Iliich246\YicmsCommon\CommonModule', ], 'pages' => [ 'class' => 'Iliich246\YicmsPages\PagesModule', ], 'essences' => [ 'class' => 'Iliich246\YicmsEssences\EssencesModule', ], 'feedback' => [ 'class' => 'Iliich246\YicmsFeedback\FeedbackModule', ], 'redactor' => 'yii\redactor\RedactorModule', ], 

La section d'amorçage est configurée comme suit:

 'bootstrap' => ['log', 'common', 'pages', 'essences', 'feedback'], 

La section utilisateur est configurée comme suit:

 'user' => [ 'identityClass' => 'Iliich246\YicmsCommon\Base\CommonUser', 'enableAutoLogin' => true, ], 

Supprimez la section des commentaires urlManager:

 'urlManager' => [ 'enablePrettyUrl' => true, 'showScriptName' => false, 'rules' => [ ], ], 

Le framework Yii2 et le système yicms ont été correctement configurés.

Après le premier démarrage, si tout a été configuré correctement, le répertoire yicms doit être créé dans le répertoire racine du projet qui contiendra les fichiers disponibles pour les modifications utilisateur et les classes annotées automatiquement seront également créées dans celui-ci.

Description des modules Common et Pages

Le système yicms se compose de deux sections. Section Dev, qui ne doit être accessible qu'au développeur (le code peut y être brisé) et la section Admin doit être accessible à l'administrateur du site (la gestion de contenu y est effectuée). Pour commencer, vous devez vous rendre dans la section Dev, pour cela vous devez utiliser l'URL suivante:

http://< >/web/common/dev/login-as-dev?hash=123456&asDev

Après cela, le panneau Dev devrait s'ouvrir:



Commençons maintenant avec la fonctionnalité yicms. Tout d'abord, dans le module Pages, nous allons créer une page appelée index, qui sera la page principale du site. Accédez à la liste des pages et créez une nouvelle page appelée index. Par défaut, les champs title, meta_description et meta_keywords seront créés pour la page. De plus, nous allons créer un autre champ via le bouton Ajouter un nouveau champ avec le nom du texte, nous laisserons tous ses paramètres par défaut.

Maintenant, si vous suivez le lien

http://< >/web/pages/admin

la section admin s'ouvrira. La page d'index y sera disponible pour remplir le contenu. Remplissez tous les champs avec du texte libre.

Au moment de créer la section d'index dans la section dev de la page d'index, la classe Index a été créée dans le répertoire yicms / Pages / Models dans lequel des annotations ont également été créées pour les champs title, meta_description, meta_keywords, ainsi que pour le champ de texte que nous avons créé à la volée. Un objet de cette classe que nous pouvons utiliser pour obtenir la valeur des champs. Considérez comment cela peut être fait. Dans le contrôleur SiteController standard du modèle de base dans actionIndex, écrivez ce qui suit:

 /** * Displays homepage. * * @return string * @throws \Iliich246\YicmsPages\Base\PagesException */ public function actionIndex() { $indexPage = \app\yicms\Pages\Models\Index::getInstance(); return $this->render('index', [ 'indexPage' => $ indexPage ]); } 

Étant donné que la classe \ app \ yicms \ Pages \ Models \ Index a été générée automatiquement, l'auto-complétion pour elle fonctionnera dans l'EDI. Maintenant, $ indexPage peut être utilisé comme index. Ouvrez maintenant la vue d'index. Nous en supprimons tout ce qui est inutile et écrivons:

 <?php /** @var $this yii\web\View */ /** @var $indexPage \app\yicms\Pages\Models\Index */ $this->title = $indexPage->title; $this->registerMetaTag([ 'name' => 'description', 'content' => $indexPage->meta_description ]); $this->registerMetaTag([ 'name' => 'keywords', 'content' => $indexPage->meta_keywords ]); ?> <div class="site-index"> <div class="jumbotron"> <h1><?= $indexPage->text ?></h1> </div> <div class="body-content"> </div> </div> 

L'annotation de la variable $ indexPage est nécessaire pour l'auto-complétion IDE. Utilisez maintenant l'objet $ indexPage. Tous les champs que nous avons créés dans la section dev pour la page d'index sont disponibles dans l'objet de la classe Index, qui, grâce à l'annotation automatique, est complété par l'EDI après avoir entré l'opérateur flèche.

Au total, en peu de temps, nous avons créé une page d'index pour laquelle un panneau d'administration a été automatiquement créé pour modifier son contenu. Nous avons utilisé la programmation uniquement pour créer l'objet page dans le contrôleur standard du framework, et sous la forme dans laquelle nous pouvions rapidement utiliser l'objet page grâce à la saisie semi-automatique et à une interface intuitive.

Nous n'avons examiné que la plus petite partie des capacités des yicms. Maintenant, nous allons compliquer un peu la page principale du site en utilisant yicms.

yicms prend en charge le multilinguisme prêt à l'emploi. Pour activer la deuxième langue dans la section dev du module commun, sélectionnez la liste des langues, puis sélectionnez la langue russe et activez-la dedans:



Maintenant, dans le panneau d'administration, nous pouvons remplir les champs pour plusieurs langues. Vous pouvez créer de nouvelles langues dans le système. Cependant, il sera nécessaire de traduire le panneau d'administration à l'aide des outils de framework habituels. Par conséquent, lors de la création d'un nouveau langage, vous devez adhérer à l'ISO. Pour les contrôles de contenu, une nouvelle plaque avec une nouvelle langue sera simplement ajoutée.

Blocs de fichiers de composants

Ensuite, considérez l'élément de blocs de fichiers. Dans le panneau de développement de la page d'index, créez un bloc de fichiers avec le document de nom de programme. Les autres paramètres de blocage seront laissés par défaut. Maintenant, dans le panneau d'administration pour l'édition de la page d'index du fichier de document est devenu disponible. Téléchargez un fichier arbitraire. Maintenant, le lien pour le télécharger peut être affiché sur la page d'index du site:

 … <div class="body-content"> <div class="row"> <h3>Document</h3> <a href="<?= $indexPage->document->uploadUrl() ?>"> <?= $indexPage->document ?> </a> </div> … </div> 

Maintenant, sur la page, le lien chargera le fichier que nous avons téléchargé sur le panneau d'administration. Par défaut, le bloc de fichiers fonctionne en mode fichier unique dans toutes les langues. Cependant, dans le panneau de développement, vous pouvez basculer le type de langue sur le type traduisible, puis pour chaque langue, il sera nécessaire de télécharger son propre fichier. Dans ce cas, le fichier dont la langue est actuellement active sur le site sera téléchargé via le lien. Bien sûr, vous pouvez télécharger pour une langue spécifique, qui sera discutée plus tard.

L'étape suivante dans le panneau de développement consiste à créer un bloc de fichier de recettes pour lequel nous spécifierons le type comme type multiple. Dans ce mode, vous pouvez télécharger de nombreux fichiers pour un bloc de fichiers. Pour ce faire, dans le panneau d'administration, dans l'onglet recettes qui apparaît, téléchargez plusieurs fichiers arbitraires.
Après cela, sous forme d'index, nous listons les fichiers:

 … <div class="row"> <h3>Recipes</h3> <?php foreach ($indexPage->recipes as $recipe): ?> <a href="<?= $recipe->uploadUrl() ?>"> <?= $recipe ?> </a> <?php endforeach; ?> </div> … 

En mode de type multiple, un bloc de fichiers peut être contourné via foreach ou un itérateur.

Composant de bloc d'images

Considérons maintenant l'élément de bloc d'images. Créez un bloc d'image pour la page d'index, en laissant tous les paramètres par défaut. De même pour les blocs de fichiers dans le panneau d'administration, il est devenu possible de télécharger une image. Téléchargez une image arbitraire. Maintenant, sous forme d'index, nous écrivons ce qui suit:

 <div class="row"> <h3>Image</h3> <img src="<?= $indexPage->picture ?>" alt=""> </div> 

De même que pour les fichiers image, un est chargé par défaut dans toutes les langues, cependant, pour les images, ce comportement peut être modifié dans le panneau de développement et télécharger votre propre image pour chaque langue. Vous pouvez également télécharger de nombreuses images dans un seul bloc.

Créez un bloc de galerie d'images dans le panneau de développement, dont le type sera défini comme Images multiples. Pour les images, vous pouvez également suspendre des champs de texte à la volée. Par conséquent, dans la fenêtre modale pour définir le bloc de la galerie, passons à la section «Afficher le champ du bloc d'image». Dans cette section pour les images, créez des champs avec les noms alt et name. Maintenant, dans le panneau d'administration pour chaque image, il est possible de définir les champs de texte alt et name. Dans les yicms pour les images hors de la boîte est également disponible la possibilité de "recadrer" et de créer des vignettes. Par exemple, créez un modèle de miniature pour le bloc de la galerie. Dans la fenêtre modale du bloc d'image, accédez à la section "Vignettes de configuration des images". Nous y créerons un configurateur de vignettes avec le nom «x2» et les paramètres diviseur = 2 et qualité = 80. Par nom, nous pourrons accéder à la vignette, le diviseur déterminera de combien réduire la taille de l'image originale, la qualité détermine la qualité de compression de la vignette. Ensuite, créez un autre modèle de miniature avec les paramètres: nom_programme = "x5", diviseur = 5, qualité = 50. Maintenant, lorsque nous chargeons l'image à partir du panneau d'administration, deux miniatures seront automatiquement créées pour elle avec les paramètres que nous avons sélectionnés.

Téléchargez maintenant quelques images dans le panneau d'administration du groupe de galeries. Une fois l'image créée et téléchargée, vous pouvez remplir les champs alt et name, dont nous avons créé les modèles dans le panneau de développement. Voyons comment afficher tout cela sur le site.

 <div class="row"> <?php foreach($indexPage->gallery->getImages() as $image): ?> <div class="col-lg-4"> <img src="<?= $image ?>" width="100%" alt="<?= $image->alt ?>"> <img src="<?= $image->outputThumbnail('x2') ?>" alt="<?= $image->alt ?>"> <img src="<?= $image->outputThumbnail('x5') ?>" alt="<?= $image->alt ?>"> <p><?= $image->name ?></p> </div> <?php endforeach; ?> </div> 

Ici, la méthode getImages () renvoie un tableau d'objets de la classe annotée automatiquement app \ yicms \ Pages \ Models \ Index \ Images \ GalleryImage dans laquelle des annotations ont été créées pour les champs alt et name que nous avons créés à la volée et l'auto-complétion IDE leur est disponible. De plus, en appelant la méthode outputThumbnail (<Nom du modèle de miniature>) sur l'objet, nous basculons l'objet en mode de sortie miniature.

Pour les blocs d'images, il est possible de créer non seulement des champs mais aussi des conditions, que nous considérerons un peu plus tard. Des champs et des conditions peuvent également être créés pour les blocs de fichiers. Cela fonctionne sur un principe similaire.

Conditions des composants

Considérons maintenant l'élément suivant. Ce sont des conditions. Les conditions sont pratiques pour la création dans les listes du panneau d'administration, les cases à cocher, etc. Ce qui déterminera certains comportements lors du travail des pages. Regardons un exemple. Créez une condition appelée arrière-plan dans le panneau de développement de la page d'index. Tapez sélectionnez «sélectionner le type de liste déroulante». Après avoir créé la condition, nous irons à la section "Options de configuration de la condition". Créez trois valeurs de condition avec les valeurs transparent, rouge et vert.

Après cela, une condition avec une liste déroulante avec les valeurs TRANSPARENT, RED et GREEN apparaîtra dans le panneau d'administration de la page d'index. Ils sont convertis en majuscules, car dans la classe créée annotée automatiquement, ils sont représentés sous forme de constantes.

Essayons maintenant d'utiliser la condition créée. Nous l'utilisons d'une manière légèrement différente pour montrer d'autres possibilités. Étant donné que la page d'index est la page principale du site, il sera sémantiquement vrai de changer la couleur d'arrière-plan du site à partir de ses paramètres. Par conséquent, notre condition sera de changer la couleur d'arrière-plan sur tout le site, nous allons donc l'insérer dans la disposition du contrôleur. Ouvrez le fichier de modèle de mise en page du framework Yii2 de base et créez un objet Index:

 <?php /* @var $this \yii\web\View */ /* @var $content string */ use app\widgets\Alert; use yii\helpers\Html; use yii\bootstrap\Nav; use yii\bootstrap\NavBar; use yii\widgets\Breadcrumbs; use app\assets\AppAsset; AppAsset::register($this); $pagesIndex = \app\yicms\Pages\Models\Index::getInstance(); ?> <?php $this->beginPage() ?> <!DOCTYPE html> <html lang="<?= Yii::$app->language ?>"> <head> <meta charset="<?= Yii::$app->charset ?>"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <?php $this->registerCsrfMetaTags() ?> <title><?= Html::encode($this->title) ?></title> <?php $this->head() ?> </head> <body> <?php $this->beginBody() ?> … 

Étant donné que l'objet de la classe Index est quelque chose comme un singleton, nous pouvons appeler la méthode statique getInstance () autant que nous le voulons sans risquer de créer des requêtes de base de données en double supplémentaires et d'autres frais généraux lors de sa création. Maintenant, en utilisant l'objet $ pagesIndex, nous allons changer la balise en lui ajoutant un style en ligne:

 <body style="background-color: <?php if ($pagesIndex->background->value() == \app\yicms\Pages\Models\Index\Conditions\Background::TRANSPARENT):?> transparent; <?php elseif ($pagesIndex->background->value() == \app\yicms\Pages\Models\Index\Conditions\Background::RED):?> #FFD3D3 <?php else: ?> #BBFFC8 <?php endif; ?> "> 

En appelant $ pagesIndex-> ​​background-> value () et en comparant avec la constante qui a été créée dans la classe annotée automatiquement \ app \ yicms \ Pages \ Models \ Index \ Conditions \ Background, nous sélectionnons la couleur d'arrière-plan du site.

Ensuite, considérez les capacités des classes à annotation automatique. Pendant que yicms est en cours d'exécution, de nombreux événements se produisent qui peuvent être gérés par le framework Yii. Nous donnons un exemple.

 app\yicms\Pages\Models\Index\Fields\Text 

Ce fichier a été créé par un annotateur automatique lorsque nous avons créé le champ de texte pour la page d'index dans le panneau de développement. Lorsque nous écrivons <? = $ IndexPage-> text?> Dans le modèle, quelque chose de similaire au singleton de cette classe particulière est créé, qui dans le modèle est converti en chaîne à l'aide de la magie __toString ().

Pour modifier le contenu, nous nous abonnons à l'événement et le traitons via la fonction de rappel:

 class Text extends Field { public function init() { $this->on(self::EVENT_BEFORE_OUTPUT, function($event) { /** @var $event \Iliich246\YicmsCommon\Base\HookEvent */ }); } } 

L'événement EVENT_BEFORE_OUTPUT se produit avant l'affichage du contenu du champ. Essayons de le changer. Pour ce faire, nous utilisons l'objet événement \ Iliich246 \ YicmsCommon \ Base \ HookEvent:

 $this->on(self::EVENT_BEFORE_OUTPUT, function($event) { /** @var $event \Iliich246\YicmsCommon\Base\HookEvent */ $value = $event->getHook(); $value = strrev($value); $event->setHook($value); }); 

L'événement HookEvent obtient la valeur du champ avant le déclenchement de l'événement. Dans l'événement, vous pouvez obtenir cette valeur via $ event-> getHook (), la modifier et la renvoyer à l'objet via l'événement en utilisant $ event-> setHook ($ value). Ainsi, dans le cas contraire, nous avons inversé le texte que le champ Texte affiche.

Presque chaque classe auto-louée a un certain nombre d'événements qui peuvent être connectés de manière similaire, mais leur examen dépasse le cadre de l'article d'enquête.

Au total, dans cet article, nous avons examiné deux modules yicms, à savoir les modules Common et Pages. Le module commun comprend des composants tels que les champs, les blocs de fichiers, les blocs d'images et les conditions. Le module Pages est chargé de créer des objets de page qui contiennent tous les éléments du module Commun. C'est-à-dire tous les modules yicms dépendent du module commun principal.

Module Yii2-yicms-essences

Maintenant, familiarisons-nous avec le module Essences. Ce module est conçu pour créer des entités de type catégorie-> entité, par exemple, la catégorie de biens-> biens, type de véhicule (voitures, moto) -> véhicule spécifique, etc. Dans le module, ces éléments sont appelés catégories et représentations.

À titre d'exemple, nous montrons la création d'un simple catalogue de la catégorie-> type de produit pour une boutique en ligne.

Dans la section Dev du module Essences, allez à la liste des essences et là nous allons à la section Créer une nouvelle essence. Nous lui donnons le nom du programme produits et laissons le reste des paramètres par défaut. Par défaut, une entité avec un comportement est créée: une vue peut appartenir à une catégorie. Cependant, vous pouvez spécifier d'autres comportements: créer simplement des vues sans catégories, ou une vue peut appartenir à plusieurs catégories.

Les catégories elles-mêmes sont construites sur un principe arborescent, lorsqu'une catégorie a un parent (à l'exception de la plus haute). C'est-à-dire Les catégories sont des feuilles d'une structure de données de type arbre.

Total des produits d'entité créés. Pour elle, des classes annotées automatiquement ont été créées dans le répertoire app \ yicms \ Essences \ Models. Ensuite, dans le panneau de développement, nous devons créer des modèles de classe et des modèles de présentation. Tout cela est similaire à la façon dont nous les avons créés pour la page d'index. Les éléments Champs, Blocs de fichiers, Blocs d'images et Conditions sont disponibles pour eux en mode de création à la volée. Une fois que nous avons fini de créer des modèles dans le panneau d'administration, il devient disponible pour créer des catégories et des vues avec les éléments de modèle que nous avons définis dans le panneau de développement.

Nous allons donc créer plusieurs catégories de marchandises. Et pour chaque catégorie de produits, il existe plusieurs produits. Une fois cela fait, le tout peut être affiché sur le site principal. Considérez comment cela se fait. Dans SiteController, créez une action actionProcuts:

 /** * * @return string */ public function actionProducts() { $productsEssence = Products::getInstance(); return $this->render('products', [ 'productsEssence' => $productsEssence ]); } 

Créez une vue des produits pour elle

 <?php /** @var $this yii\web\View */ /** @var $productsEssence \app\yicms\Essences\Models\Products */ ?> <div class="body-content"> <?php foreach($productsEssence->categories as $category): ?> <h1>: <?= $category->name ?></h1> <?php foreach($category->represents as $product): ?> <h2>: <?= $product->name ?></h2> <?php endforeach; ?> <?php endforeach; ?> </div> 

Grâce au mécanisme d'annotation automatique, la méthode $ productsEssence-> categories renvoie un tableau d'objets de la classe annotée automatiquement app \ yicms \ Essences \ Models \ ProductsCategory. Comme dans les classes auto-annotées précédentes de cette classe, il y a des annotations sur les champs que nous avons créés à la volée, l'EDI pourra utiliser l'auto-complétion. Il convient également de noter que les classes auto-annotées ont été développées avec l'idée que l'utilisateur yicms pourra y placer sa propre logique métier, c'est-à-dire vous pouvez y écrire votre propre code et le mécanisme d'annotation automatique modifie les zones spécialement marquées et aucun code utilisateur ne sera affecté.

La méthode $ category-> represent renvoie également un tableau d'objets app \ yicms \ Essences \ Models \ ProductsRepresent qui ont tous les mêmes avantages d'annotation automatique que pour les catégories. Bien sûr, il existe des méthodes plus souples pour obtenir des idées. Par exemple, $ category-> getRepresentQuery () retournera un objet ActiveQuery du framework Yii2, qui peut être personnalisé pour affiner la requête de base de données, utilisé pour créer une pagination ou un chargement paresseux.

Au total, le module Essenses vous permet de créer rapidement un squelette des fonctionnalités de la boutique, avec le panneau d'administration fonctionnant déjà. Une logique métier supplémentaire peut être écrite dans des classes annotées automatiquement.

Module de rétroaction Yii2-yicms

Ce module est destiné à construire des formulaires de saisie d'informations sur le site par les visiteurs et les utilisateurs du site. L'idéologie du travail reste la même, d'abord dans le panneau de développement, nous tapons les champs requis pour le formulaire.

Prenons l'exemple du fonctionnement du module. Créez un enregistrement avec les messages de nom de programme dans le panneau de développement du module de rétroaction. Sur la page des paramètres des messages, nous pouvons voir le bouton Modèles de pages de commentaires. En utilisant ce lien, nous pouvons créer des éléments du champ type, bloc de fichiers, bloc d'images, conditions qui peuvent être utilisées pour formater le contenu de la page des messages. Ils ne sont pas différents de ceux que nous avons considérés pour le module Pages. Maintenant, nous sommes plus intéressés par la section Modèles de saisie de commentaires. Dans cette section, nous pouvons créer des entités telles que des champs d'entrée, des fichiers d'entrée, des images d'entrée et des conditions d'entrée. Ces entités sont exactement ce dont vous avez besoin pour créer des formulaires de saisie personnalisés.

Créez deux champs de saisie avec les noms nom et prénom.Image d'entrée nommée photo. Condition d'entrée nommée accord. Pour l'instant, laissons tous les paramètres de ces entités par défaut. Plus loin dans cet exemple, nous allons configurer des validateurs qui sont également suspendus à ces entités à la volée (les validateurs sont également disponibles pour les entités du module commun et fonctionnent selon la même logique que pour le module de rétroaction. Nous en discuterons un peu plus tard).

Appliquez maintenant le module sur notre site Web. Tout d'abord, créez une nouvelle action dans SiteController:

 /** * @return string */ public function actionMessage() { $messages = \app\yicms\Feedback\Models\Messages::getInstance(); return $this->render('message', [ 'messages' => $messages ]); } 

Ensuite, créez une vue de message et écrivez ce qui suit:

 <?php /** @var $this yii\web\View */ /** @var $message \app\yicms\Feedback\Models\Messages */ ?> <?php $form = \yii\bootstrap\ActiveForm::begin([ 'id' => 'some-form', 'options' => [ 'data-pjax' => true, ], ]); ?> <div class="row"> <div class="col-xs-12"> <?= \yii\helpers\Html::submitButton('Save', ['class' => 'btn btn-success']) ?> </div> </div> <?php \yii\bootstrap\ActiveForm::end(); ?> 

Pour créer le formulaire, nous utiliserons les outils standards du framework. Afin de profiter du module de rétroaction, nous écrirons ce qui suit:

 <?php if ($messages->input_name->isActive): ?> <?= $form->field($messages->input_name, $messages->input_name->key) ?> <?php endif; ?> <?php if ($messages->input_surname->isActive): ?> <?= $form->field($messages->input_surname, $messages->input_surname->key) ?> <?php endif; ?> <?php if ($messages->input_photo->isActive): ?> <?= $form->field($messages->input_photo, $messages->input_photo->key) ->fileInput() ?> <?php endif; ?> <?php if ($messages->input_agreement->isActive): ?> <?= $form->field($messages->input_agreement, $messages->input_agreement->key)->checkbox() ?> <?php endif; ?> 

Pour les entités de type entrée, vous devez utiliser le préfixe input_, sinon, les annotations automatiques fonctionnent pour elles de la même manière que pour le reste des choses en yicms.

Au début, il y a une vérification de l'activité du champ, si le champ est inactif, alors il ne doit pas être rendu, et même s'il est rendu, les données qui ont été remplies ne seront pas téléchargées sur le serveur. L'activité sur le terrain peut être activée / désactivée dans le panneau de développement.

Vient ensuite la forme standard du cadre où vous devez écrire comme ceci

 $form->field($messages->input_name, $messages->input_name->key) 

$ messages-> nom_entrée renverra un objet de la classe app \ yicms \ Feedback \ Models \ Message \ InputFields \ Name qui est le descendant du framework Model Yii2 et peut être utilisé dans les formulaires, $ messages-> nom_entrée-> key retournera la valeur de clé correcte, dans l'ordre afin que le formulaire puisse être chargé.

Maintenant, lorsque nous allons à la page avec le formulaire, tous ses champs sont rendus, mais le chargement sur le serveur ne fonctionne pas encore. C'est très simple à faire. J'ai essayé de rendre l'interface de travail de rétroaction aussi similaire que possible à l'interface de travail du modèle dans le cadre. Oui, j'ai dû "sacrifier" un peu d'architecture, mais dans l'ensemble cela s'est avéré comme ceci:

 public function actionMessage() { $messages = \app\yicms\Feedback\Models\Messages::getInstance(); if ($messages->load(Yii::$app->request->post()) && $messages->validate()) { $messages->handle(); } return $this->render('message', [ 'messages' => $messages ]); } 

Le formulaire va maintenant se charger, valider et enregistrer sur le serveur. Dans la section admin, nous pouvons voir les informations qui ont été saisies dans le formulaire.

Bien sûr, vous pouvez utiliser une classe annotée automatiquement:

\app\yicms\Feedback\Models\Messages

 class Messages extends Feedback { /** * @return self instance . */ public static function getInstance() { return self::getByName('messages'); } /** * @inheritdoc */ public function init() { $this->on(self::EVENT_AFTER_HANDLE, function($event) { Yii::$app->mailer->compose('message', [ 'message' => $this ]) ->setFrom('from@domain.com') ->setTo('to@domain.com') ->setSubject('Message subject') ->send(); }); } } 

Dans cet exemple, nous nous sommes inscrits à l'événement EVENT_AFTER_HANDLE. L'événement se produit après que les données du formulaire ont été enregistrées sur le serveur. Dans ce cas, nous envoyons une lettre au modèle dont nous pouvons insérer les données de formulaire enregistrées:

 <?php /** @var $this \yii\web\View view component instance */ /** @var $message \app\yicms\Feedback\Models\Message */ ?> <h1>Mail on message</h1> <h1>Name: <?= $message->input_name->value ?></h1> <h2>Surname: <?= $message->input_surname->value ?></h2> 

$ message-> input_name-> value renvoie simplement les données actuelles qui ont été stockées dans la base de données.

Voyons maintenant comment fonctionnent les validateurs. Dans le panneau de développement de l'entité de champ de saisie portant le nom, ajoutez le validateur requis. Il s'agit du validateur de framework yii \ validators \ RequiredValidator standard. Lorsque nous l'avons ajouté, il n'est pas encore actif, car le bouton avec son nom est blanc. Pour l'activer, vous devez cliquer sur ce bouton, la fenêtre des paramètres du validateur s'ouvrira. Là, vous devez installer la case à cocher et l'activer. Dans le même temps, vous pouvez configurer tous les autres paramètres du validateur, tels que les messages d'erreur dans toutes les langues du système, etc. Après l'enregistrement, l'icône du validateur devient verte, ce qui signifie qu'elle est devenue active et sera appliquée lors de la validation des formulaires.

À l'entrée_condition avec l'accord de nom, nous suspendons le validateur de comparaison. Et configurez-le pour comparer avec 1, tapez numéro et l'opérateur ==. De plus, vous pouvez écrire un message dans les champs de texte d'erreur, tel que «Vous devez accepter les termes de l'offre». Désormais sur le formulaire, la validation n'aura lieu que si la case à cocher de l'accord est cochée.

Au total, dans cet article, nous avons examiné les principales caractéristiques du système yicms.