Articles

Բացառությամբ Drupal 7-ի, Drupal 8-ում ձեր կայքում տեղադրելու համար մի քանի բլոկի օրինակ ստեղծելը շատ հեշտ գործ է։

Այս ուղեցույցում դուք կսովորեք, թե ինչպես ծրագրային ճանապարհով բլոկ ավելացնել բլոկի դասավորության ինտերֆեյսում։ Ինչպես ավելացնել (աշխատանքային) կոնֆիգուրացիոն ֆորմ բլոկին և ինչպես այն մշակել։ Վերջապես, դուք կսովորեք, թե ինչպես ավելացնել և ցուցադրել ձևի համար նախնական կոնֆիգուրացիոն արժեքներ։

Բլոկները Drupal 8-ում բլոկի պլագինի օրինակներ են։
Բլոկների մենեջեր-ը Drupal-ում սկանավորում է ձեր մոդուլները այն դասերի համար, որոնք պարունակում են @Block անոտացիա:

Ներկայացված կոդի օրինակն օգտագործում է @Block անոտացիան՝ «id» և «admin_label» հատկություններով՝ օգտատիրոջ բլոկը սահմանելու համար։

Այժմ ասենք, որ մենք ուզում ենք ավելացնել հնարավորություն՝ կայքի ստեղծողին ներմուծելու կոնֆիգուրացիայի մի մասը մեր կસ્ટમ բլոկի յուրաքանչյուր օրինակ համար։ Միշտ հիշեք, որ Drupal 8-ում կայքի բոլոր կոնֆիգուրացիաները կարող են արտահանվել մշակման կայքից և ներմուծվել արտադրական կայք (հայտնի է որպես Կոնֆիգուրացիայի կառավարում)։ Դուք՝ մոդուլների հավաքող, կարող եք նաև տրամադրել նախնական կոնֆիգուրացիա, որպեսզի ավտոմատ լցնի ձևը, երբ կայքի ստեղծողը ստեղծում է նոր բլոկ։

Ավելացրեք հետևյալ մեթոդը HelloBlock դասին։ Այս օրինակով այն գտնվում է src/Plugin/Block/HelloBlock.php ֆայլում, բայց ինչպես դուք սկսում եք մտածել ավելի OOP ոճով, ֆիզիկապես ֆայլերի կառուցվածքում դրա գտնվելու վայրը պակաս կարևոր է, քան տարածքի անվանումը։ Եթե դուք շատ խելացի OOP ծրագրավորող եք, դուք երկու բան պահում եք շատ խիստ համընկնում։ Բայց ակնհայտ է, որ իրականում տարածքի անունը շատ նման է մոդուլի պանակի անվանը և մեքենայի անվանը մեր այս բաժնում նախկինում քննարկված մոդուլի համար, և դա կարևոր կլինի ավելի ուշ, երբ ցանկանաք ծրագրային շփում ունենալ ձեր մոդուլի կոդի հետ։

Բլոկի օրինակների կարգավորումները օգտագործելու համար մենք կարող ենք փոփոխել HelloBlock դասի build() մեթոդը հետևյալ կերպ՝

  /**
   * {@inheritdoc}
   */  
  public function build() {
    $config = $this->getConfiguration();

    if (!empty($config['hello_block_name'])) {
      $name = $config['hello_block_name'];
    }
    else {
      $name = $this->t('to no one');
    }

    return [
      '#markup' => $this->t('Hello @name!', [
        '@name' => $name,
      ]),
    ];
  }

Բաժին V Դրամական ուղեցույց Drupal 8-ի հիմնական մոդուլների ստեղծման համար
.info-ից մինչև թեստեր, միայն հիմնականները

Հիշո՞ւմ եք, որ սկզբում այս դասի մեջ ասել էի, որ մենք կսահմանենք բլոկ՝ ֆորմայով։ Հիմա ժամանակն է այդ հարցին անդրադառնալու։

Այս ուղեցույցը ներառում է սեփական դաշտի տեսակի, վիջեթի և ֆորմատորի ստեղծման հրահանգներ Drupal 8-ում։

Այս ձեռնարկը սկզբնապես հրապարակվել է Web Wash-ում։ Սակայն Berdir-ը հարցրեց, թե արդյոք կարող եմ տեղադրել ձեռնարկը այստեղ, ուստի այն հիմա այստեղ է։

Drupal 7-ում մոդուլը թույլ է տալիս դաշտում պահել կոդի օրինակներ/հատվածներ։ Այն տրամադրում է հարմարեցված դաշտ, որը կոչվում է «Կոդի հատվածների դաշտ» և ցուցադրում է երեք ֆորմայի էլեմենտ՝ նկարագրություն, աղբյուրային կոդ և սինտաքսի ընդգծման ռեժիմ (программային լեզու)։

Հիմա ժամանակն է մոդուլը թարմացնել Drupal 8-ի համար։

Drupal 8-ում բոլոր դաշտի տիպերը, վիջեթներն ու ֆորմատավորողները plugin-ներ են։

Նրանք ավտոմատ հայտնաբերվում են, եթե գտնվում են սպասվող ֆայլերի կառուցվածքում և օգտագործում են ճիշտ անոտացիա։

Մոդուլի այնպիսի կառուցվածքը, որը իրականացնում է երեքն էլ, այսպես է թվում՝

foo_bar_fields

Դաշտի տիպերը սահմանում են դաշտերի հատկություններն ու վարքագիծը։ Դաշտի տիպերը սահմանվում են որպես plugin-ներ, ուստի խորհուրդ է տրվում ծանոթանալ plugin API-ին նախքան նոր դաշտի տիպի ստեղծումը։

Drupal 8-ում դաշտի տիպ ստեղծելու համար անհրաժեշտ է դաս, որի վրա առկա է FieldType անոտացիա։

Դասի տեղադրումը պետք է լինի MODULE_NAME/src/Plugin/Field/FieldType, օրինակ՝ /modules/foo/src/Plugin/Field/FieldType/BazItem.php։