Միացրեք կանխադրված կոնֆիգուրացիան ձեր Drupal 8 մոդուլում

Հիմնական թեմա՝ նախնական կոնֆիգուրացիա

Դիտարկում

Drupal 7-ում նախնական կոնֆիգուրացիայի համար՝ այնպիսի մոդուլների համար, ինչպիսիք են պարունակության տեսակները, դաշտերի կոնֆիգուրացիան, դիտումները և այլն, անհրաժեշտ էր հատուկ PHP կոդ տեղադրման և թարմացման համար։ Drupal 8-ում դրանք պահվում են կոնֆիգուրացիայի համակարգի հետ միասին YAML տեքստային ֆայլերում։

Օրինակ, կոնֆիգուրացիայի կառավարման համակարգը հոգում է պարունակության տեսակների ստեղծման և կառավարելու մասին։ Դուք կարող եք ձեր մոդուլի հետ միասին ուղարկել պարունակության տեսակ՝ ստեղծելով համապատասխան անունով և կառուցվածքով կոնֆիգուրացիայի ֆայլ։

Օրինակ

Ստեղծեք node.type.example_mytype.yml անունով ֆայլ և տեղադրեք այն ձեր մոդուլի config/install ենթաթղթապանակում։ Օրինակ, այս ֆայլը կարող է գտնվել /modules/example/config/install/node.type.example_mytype.yml, եթե ձեր մոդուլը գտնվում է /modules/example։

Խնդրում ենք պահպանել անվանման համաձայնությունը, որի համաձայն ձեր պարունակության տեսակի անունը դնում եք մոդուլի անունից առաջ՝ ստորակետով բաժանված, որպեսզի խուսափեք կոնֆլիկտներից մյուս կոնֆիգուրացիոն ֆայլերի հետ։

Այնուհետև կարող եք տեղադրել հետևյալ կոդը այդ ֆայլում՝

type: example_mytype
name: Example
description: 'Օգտագործեք <em>example</em> պարունակությունը՝ Drupal 8-ի զարգացումը ավելի լավ հասկանալու համար։'
help: ''
new_revision: false
display_submitted: true
preview_mode: 1
status: true
langcode: en

Դիտեք node.type.article.yml որպես կենդանի օրինակ։

Դուք կարող եք միացնել նախնական կոնֆիգուրացիան նաև այլ տարրերի համար՝ ինչպես բլոկների տեղադրում, դիտումներ, տեքստային ֆորմատներ, խմբագրողի կոնֆիգուրացիա, օգտվողների դերեր և այլն՝ նույն ձևով։

Դուք կարող եք սահմանել նաև ձևերի դաշտերի նախնական արժեքներ, օրինակ՝ հանգույցի հեղինակ։

Եթե մոդուլը տեղադրվել է այս պարունակության տեսակն ավելացնելուց առաջ, ապա պետք է ջնջել և նորից տեղադրել մոդուլը, որպեսզի կոնֆիգուրացիան ուժի մեջ մտնի։

Կոնֆիգուրացիայի արտահանում

Դուք կարող եք ստեղծել այս ֆայլերը՝ արտահանելով կոնֆիգուրացիան Կոնֆիգուրացիա > Զարգացում > Կոնֆիգուրացիայի սինխրոնացում բաժնում։ Կարող եք օգտվել «Մեկը ներմուծել/արտահանել» գործառույթից՝ կոնֆիգուրացիայի մեկ կտոր արտահանելու համար, և այդ դեպքում ձեզ կտրամադրվի տեքստային դաշտ՝ կոդը պատճենելու/տեղադրելու համար կոնֆիգուրացիայի ֆայլում։ Կամ կարող եք կատարել «Լրիվ արտահանում», որը թույլ կտա ներբեռնել tar.gz ֆայլ՝ ներառյալ բոլոր կոնֆիգուրացիայի ֆայլերը մեկ թղթապանակում։

Արտահանված կոնֆիգուրացիա օգտագործելիս կարևոր է հեռացնել UUID-ը կոնֆիգուրացիայից։ Յուրաքանչյուր կոնֆիգուրացիոն հատված յուրահատուկ նույնականացվում է այս ID-ով։ Եթե դուք ներառեք այս UUID-ը ձեր մոդուլում, ապա նույն ID-ն կգտնվի բոլոր կայքերում, որոնք օգտագործում են ձեր մոդուլը, ուստի այն այլևս չի լինի եզակի։ Եթե պարզապես հեռացնեք այս տողը կոնֆիգուրացիայից, Drupal-ը կստեղծի նոր UUID, երբ ձեր մոդուլը միացվի, ապահովելով եզակինությունը։

uuid: 626187e6-2176-4a73-8900-c0912580e4a1 << Հեռացրեք սա!
langcode: en
status: true

Drupal Կոնսոլ

Drupal Console օգտակարությունը տրամադրում է հետևյալ հրամանը․

• config:export:content:type

Այն կատարելու է հետևյալ առաջադրանքները՝

• Արտահանում է կոնֆիգուրացիայի բոլոր ֆայլերը, որոնք կապված են նշված պարունակության տեսակի հետ (ներառյալ դաշտի կոնֆիգուրացիայի ֆայլերը)։
• Տեղադրում է դրանք անհրաժեշտ մոդուլի կոնֆիգուրացիայի թղթապանակում։

Այսպիսով, սա խնայում է շատ աշխատանք, որը պահանջվում է վերոնշյալ ձեռքով գործընթացով։

Տես նաև

• YAML
• Drupal 8 կոնֆիգուրացիայի համակարգ