9.7. Drupal-ի պլագիններ։ Ինչպես ծրագրային եղանակով բլոկ ավելացնել։

Այս դասում մենք կծանոթանանք, թե ինչպես կարելի է ծրագրային եղանակով բլոկեր արտածել սեփական մոդուլի միջոցով Drupal 8-ում։

Կոդի օրինակները կարող եք դիտել GitHub-ում.
https://github.com/levmyshkin/drupalbook8

Սկսենք ֆայլ ավելացնելով, որը պարունակում է PHP դաս։ Այս կերպ են բլոկերը ստեղծվում Drupal-ում՝ սեփական մոդուլի միջոցով։ Ֆայլ ստեղծելու գործընթացը նման է էջի դասի ստեղծմանը, ինչպես արեցինք այստեղ․

9.3. Ստեղծել սեփական Drupal մոդուլ։ Էջի արտածում ծրագրային եղանակով։

Պարզապես անհրաժեշտ է ստեղծել պլագինի ֆայլ՝

modules/custom/drupalbook/src/Plugin/Block/FirstBlock.php

Ահա այս բլոկի կոդը, որի հատվածները կվերլուծենք ստորև
modules/custom/drupalbook/src/Plugin/Block/FirstBlock.php:

<?php

namespace Drupal\drupalbook\Plugin\Block;

use Drupal\Core\Access\AccessResult;
use Drupal\Core\Block\BlockBase;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Session\AccountInterface;

/**
 * Պարունակում է պարզ տեքստով բլոկ։
 *
 * @block(
 *   id = "drupalbook_first_block_block",
 *   admin_label = @block("Իմ առաջին բլոկը"),
 * )
 */
class FirstBlock extends BlockBase {
  public function build() {
    $config = $this->getConfiguration();

    if (!empty($config['drupalbook_first_block_settings'])) {
      $text = $this->t('Բարև @Name բլոկում!', ['@Name' => $config['drupalbook_first_block_settings']]);
    }
    else {
      $text = $this->t('Բարև աշխարհ բլոկում!');
    }

    return [
      '#markup' => $text,
    ];
  }

  protected function blockAccess(AccountInterface $account) {
    return AccessResult::allowedIfHasPermission($account, 'access content');
  }

  public function blockForm($form, FormStateInterface $form_state) {
    $config = $this->getConfiguration();

    $form['drupalbook_first_block_settings'] = [
      '#type' => 'textfield',
      '#title' => $this->t('Անուն'),
      '#description' => $this->t('Ո՞ւմ եք ցանկանում բարևել։'),
      '#default_value' => !empty($config['drupalbook_first_block_settings']) ? $config['drupalbook_first_block_settings'] : '',
    ];

    return $form;
  }

  public function blockSubmit($form, FormStateInterface $form_state) {
    $this->configuration['drupalbook_first_block_settings'] = $form_state->getValue('drupalbook_first_block_settings');
  }
}

Մենք կտեղադրենք մեր բլոկը ձախ սյունակում կամ այն վայրում, որտեղ Ձեզ հարմար կլինի։

Սկսեք մուտքագրել ձեր բլոկի անունը, և Drupal-ը ավտոմատ կառաջարկի ընտրել այն։ Եթե բլոկը ցուցադրված չէ, ստուգեք՝ արդյոք կոդը ճիշտ ֆայլում է, և արդյոք ֆայլը ճիշտ դիրք目录ում է։ Ապա մաքրեք քեշը։

Երբ բլոկը ցուցադրվի, տեսնենք, թե ինչպես է աշխատում բլոկի կոդը․

Ֆայլի սկզբում մենք նշում ենք namespace, որպեսզի Drupal-ը կարողանա ավտոմատ միացնել ֆայլը։

namespace Drupal\drupalbook\Plugin\Block;

use Drupal\Core\Access\AccessResult;
use Drupal\Core\Block\BlockBase;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Session\AccountInterface;

@block-ի միջոցով մենք նշում ենք, որ սա բլոկի պլագին է։ id-ն և admin_label-ը Drupal-ը կգտնի ավտոմատ։ id-ը պետք է լինի եզակի։

Մենք ժառանգում ենք BlockBase դասից՝

class FirstBlock extends BlockBase {

Դիտարկենք build(), blockAccess(), blockForm(), blockSubmit() մեթոդները վերևում։

blockAccess() մեթոդում ստուգվում է՝ օգտատերն ունի՞ արդյոք "access content" իրավունքը։

blockForm() մեթոդում ստեղծվում է ձև՝ անուն մուտքագրելու համար, որը պահպանվում է կարգավորումներում։

blockSubmit() մեթոդը պահում է անունը Drupal-ի կոնֆիգների մեջ։

build() մեթոդը արտածում է տեքստը՝ օգտագործելով ձևով մուտքագրված անունը։

Եթե անուն չկա, ապա ցուցադրվում է լռելյայն «Բարև աշխարհ բլոկում!» տեքստը։

Այսպիսով, դուք կարող եք ծրագրային եղանակով ստեղծել և կարգավորել ձեր սեփական բլոկերը Drupal 8-ում։ Հաջորդիվ կուսումնասիրենք բարդ օրինակներ։

Կոդի օրինակները հասանելի են GitHub-ում.
https://github.com/levmyshkin/drupalbook8