Drupal 8 모듈 구축 : 블록 및 양식

코어 포인트

Drupal 8은 플러그인으로서 새로운 블록 개념을 소개하여 사이트 전체에서 재사용 할 수 있습니다. 블록은 UI에서 생성 될 수 있으며 여러 번 사용될 수 있습니다.

Drupal 8에서 구성 가능한 텍스트를 반환하는 사용자 정의 블록을 만들 수 있습니다. UI에서 새로운 블록 유형을 만들고 사이트 전체에서 재사용하여 수행 할 수 있습니다.

Drupal 8을 사용하면 블록에 구성 양식을 추가 할 수 있습니다. 이를 통해 사용자는 블록을 편집하고 텍스트 필드에 이름을 지정할 수있게 한 다음 블록이 해당 이름으로 인사말을 표시합니다.
• Drupal 8 모듈 개발에는 간단한 양식을 작성해야합니다. 양식 정의 기능은 클래스에서 함께 그룹화됩니다. 제출 된 양식 값은 화면에 단순히 인쇄되어 작동 방식을 보여줍니다.
Drupal 8에서는 사용자 정의 모듈에서 양식 클래스를 정의하여 사용자 정의 양식을 만들 수 있습니다. 양식 클래스는 "formbase"클래스를 확장하고 "getformid ()", "buildform ()"및 "downform ()"의 세 가지 방법을 구현해야합니다.
• 작성 시점에 Drupal 8의 진행중인 개발 프로세스로 인해 일부 코드 부품이 구식이 될 수 있습니다. 이 저장소를 확인하십시오. 샘플 코드를 업데이트하고 최신 Drupal 8 버전에서 작동하도록 시도했습니다.
이 시리즈의 첫 번째 부분에서는 기본부터 시작하여 Drupal 8 모듈 개발을 배웁니다. Drupal이 모듈에 필요한 파일을 이해하는 방법, 라우팅 프로세스 작동 방식 및 구성 방식으로 프로그래밍 방식으로 메뉴 링크를 만드는 방법을 배웠습니다.
• 이 튜토리얼에서는이 저장소에서 발견 된 샌드 박스 모듈을 자세히 살펴보고 두 가지 중요한 기능, 즉 블록 및 양식을 살펴 보겠습니다. 이를 위해 구성 가능한 텍스트를 반환하는 사용자 정의 블록을 만듭니다. 그런 다음 사용자가 제출 한 값을 화면에 인쇄하기위한 간단한 양식을 만듭니다.
• Drupal 8 Block

D8의 블록 API에 대한 멋진 새로운 변경 사항은 플러그인 (완전히 새로운 개념)으로 블록을 더욱 두드러지게 만드는 것입니다. 즉, 재사용 가능한 기능 (백그라운드에서)이라는 것을 의미합니다. 이제 UI에 블록을 생성하고 사이트 전체에서 재사용 할 수 있습니다. 더 이상 블록을 한 번만 사용하는 것으로 제한되지 않습니다.

기본적으로 화면에 인쇄 할 간단한 블록 유형을 만들어 봅시다. 모듈 루트에있는 SRC/플러그인/블록 폴더에서 클래스 파일 만 사용하면됩니다. 새로운 블록 유형 Demoblock의 이름을 지정하겠습니다. 물론 Demoblock.php라는 파일에 있어야합니다. 이 파일에서 우리는 다음으로 시작할 수 있습니다 :

<?php
namespace Drupal\demo\Plugin\Block;

use Drupal\block\BlockBase;
use Drupal\Core\Session\AccountInterface;

/**
 * Provides a 'Demo' block.
 *
 * @Block(
 *   id = "demo_block",
 *   admin_label = @Translation("Demo block"),
 * )
 */

class DemoBlock extends BlockBase {

  /**
   * {@inheritdoc}
   */
  public function build() {
    return array(
      '#markup' => $this->t('Hello World!'),
    );
  }

  /**
   * {@inheritdoc}
   */
  public function access(AccountInterface $account) {
    return $account->hasPermission('access content');
  }

}

다른 모든 클래스 파일과 마찬가지로, 우리는 수업을 처음으로 표시합니다. 그런 다음 <<> 블록베이스 클래스를 사용하여 확장 할 수 있고 AccountInterface 클래스를 사용하여 현재 로그인 한 사용자에 액세스 할 수 있습니다. 다음은 Drupal 7 : Comments에서 보지 못한 것입니다.

주석은 클래스 정의와 동일한 파일의 댓글 블록에있는 PHP 검색 도구입니다. 이러한 주석을 사용하여 Drupal은 id demo_block과 admin_label을 <🎜 🎜> 데모 블록 (번역 시스템을 통과 함)와 함께 새 블록 유형 (@block)을 등록하려고한다는 것을 알립니다. 다음, 블록베이스 클래스를 우리의 데모 블록으로 확장하여 두 가지 방법 (가장 일반적인 방법)을 구현합니다. build () 메소드는 블록이 인쇄 될 렌더링 가능한 배열을 반환하기 때문에 가장 중요합니다. Access () 메소드는 액세스를 제어 하여이 블록을 볼 수 있습니다. 그것에 전달 된 인수는 AccountInterface 클래스의 인스턴스이며,이 경우 현재 사용자입니다.

주목해야 할 또 다른 흥미로운 점은 더 이상 변환에 전역으로 t () 함수를 사용하지 않고 대신 학부모 클래스 클래스에서 구현 된 t () 메소드를 참조한다는 것입니다.

<,> 그게 바로 캐시를 지우고 블록 레이아웃 구성 페이지로 이동할 수 있습니다. 멋진 점은 오른쪽에 블록 유형이 있으며 (이를 통해 필터링 할 수 있음) 이러한 유형의 블록 중 하나를 사이트의 다양한 영역에 배치 할 수 있습니다. <<> Drupal 8 블록 구성

<🎜 🎜> 이제 UI에서 사용할 새 블록 유형을 만드는 방법을 배웠으므로 API를 더 깊이 파고 구성 양식을 추가합시다. 우리는 그것을 블록을 편집하고 텍스트 필드에 이름을 지정할 수있게하며, 블록은 <🎜 🎜> world <🎜 🎜>에게 인사하기보다는 해당 이름에 인사합니다.

먼저 텍스트 필드가 포함 된 양식을 정의해야합니다. 따라서 DemoBlock 클래스에서는 blockform () : <🎜 🎜>라는 새로운 메소드를 추가 할 수 있습니다.

이 양식 API 구현은 Drupal 7과 매우 유사하게 보일 것입니다. 그러나 여기에는 새로운 콘텐츠가 있습니다. 먼저 부모 클래스에서 $ 양식 배열을 검색합니다 (따라서 자체 필드를 추가하여 기존 양식을 작성합니다). 표준 OOP 물건. 그런 다음이 블록의 구성을 검색하고 저장합니다. 블록베이스 클래스는 우리를 위해이를 수행하는 getConfiguration () 메소드를 정의합니다. 설정된 경우 demo_block_settings 값을 #default_value로 배치합니다.

다음은이 양식의 제출 핸들러이며,이 양식의 값을 처리하고 청크의 구성에 저장합니다.

이 방법은 또한 DemoBlock 클래스에 위치하고 있으며, Demo_block_settings 필드의 값을 블록 구성에서 새 항목으로 저장하기 만하면됩니다 (일관성을 위해 키와 동일한 이름과 동일한 이름을 사용).

마지막으로, 우리는 다음에 묻는 이름을 포함하도록 build () 메소드를 조정해야합니다.

<?php
namespace Drupal\demo\Plugin\Block;

use Drupal\block\BlockBase;
use Drupal\Core\Session\AccountInterface;

/**
 * Provides a 'Demo' block.
 *
 * @Block(
 *   id = "demo_block",
 *   admin_label = @Translation("Demo block"),
 * )
 */

class DemoBlock extends BlockBase {

  /**
   * {@inheritdoc}
   */
  public function build() {
    return array(
      '#markup' => $this->t('Hello World!'),
    );
  }

  /**
   * {@inheritdoc}
   */
  public function access(AccountInterface $account) {
    return $account->hasPermission('access content');
  }

}

지금까지 이것은 매우 쉬워 보일 것입니다. 우리는 블록의 구성을 검색하고 필드의 값이 설정된 경우 인쇄 문에 사용합니다. 그렇지 않은 경우 일반적인 진술이 사용됩니다. 구역에 할당 한 블록을 편집하고 요청하려는 이름을 추가하여 캐시를 지우고 테스트 할 수 있습니다. 주목할만한 점은 화면에 인쇄 할 때 여전히 사용자 입력을 정리할 책임이 있다는 것입니다. 간결하게, 나는이 단계를 포함하지 않았다.

<<> 드 루 팔 8 양식

<🎜 🎜> 이 튜토리얼에서 우리가 살펴볼 마지막 것은 간단한 양식을 만드는 방법입니다. 공간 제한으로 인해 구성 관리 측면 (양식을 통해 제출 된 스토어 구성 값)을 다루지 않습니다. 대신, 제출 된 값이 단순히 화면에 인쇄되어 작동 방식을 보여주는 간단한 양식 정의를 설명합니다. Drupal 8에서 양식 정의 기능은 클래스로 그룹화됩니다. SRC/Form/Demoform.php에서 간단한 Demoform 클래스를 정의해 봅시다. OOP 측면과는 별도로 모든 것이 Drupal 7과 매우 유사해야합니다. 양식 API는 거의 변경되지 않았습니다 (일부 새로운 양식 요소 및 그러한 캡슐화를 추가하는 제외). 그래서 위에서 무슨 일이 있었나요?

먼저, 우리는 클래스를 네임 스페이스하고

코어 폼베이스 클래스를 사용하여 자신의 Demoform 클래스로 확장 할 수 있습니다. 그런 다음 우리는 4 가지 방법을 구현하며 그 중 3 개는 매우 친숙해 보일 것입니다. getformid () 메소드는 새롭고 필수이며 양식의 기계 이름을 반환하는 데만 사용됩니다. buildform () 메소드는 다시 필수적이며 양식을 작성합니다. 어떻게? Drupal 7에서 익숙한 것처럼. ValidateForm () 메소드는 선택 사항이며 그 목적은 D7에서 매우 명확해야합니다. 마지막으로, submitorform () 메소드는 커밋 처리를 수행합니다. 매우 논리적이고 조직적입니다.

그래서 우리는이 양식으로 무엇을 달성하고 싶습니까? 사용자가 작성하기를 원하는 이메일 필드 (Drupal 8의 새로운 양식 요소)가 있습니다. 기본적으로 Drupal은 입력 된 값이 실제로 이메일 주소인지 확인합니다. 그러나 검증 함수에서 우리는 그것이 .com 이메일 주소인지 확인하고 그렇지 않은 경우 해당 필드에서 양식 오류를 설정합니다. 마지막으로, 제출 핸들러는 단순히 페이지에 메시지를 인쇄합니다.

이 양식을 사용하기 위해 마지막으로해야 할 일은 경로를 제공하는 것입니다. 따라서 Demo.routing.yml 파일을 편집하고 다음을 추가하십시오 :

/**
 * {@inheritdoc}
 */
public function blockForm($form, &$form_state) {

  $form = parent::blockForm($form, $form_state);

  $config = $this->getConfiguration();

  $form['demo_block_settings'] = array(
    '#type' => 'textfield',
    '#title' => $this->t('Who'),
    '#description' => $this->t('Who do you want to say hello to?'),
    '#default_value' => isset($config['demo_block_settings']) ? $config['demo_block_settings'] : '',
  );

  return $form;
}

이것은 이전 게시물에서 간단한 페이지를 라우팅 한 것과 비슷해야합니다. 유일한 중요한 차이점은 기본값에서 _form을 사용하여 대상이 양식 클래스임을 지정한다는 것입니다. 따라서 값은 방금 만든 클래스 이름입니다.

캐시를 지우고 데모/양식으로 이동하여 양식을보고 테스트하십시오.

drupal_get_form ()에 익숙하고 Drupal 7에서했던 것처럼 양식을로드하는 방법을 알고 싶다면 대답은 글로벌 Drupal 클래스에 있습니다. 양식을 검색하려면 FormBuilder () 메소드를 사용하고 다음을 수행 할 수 있습니다.

<?php
namespace Drupal\demo\Plugin\Block;

use Drupal\block\BlockBase;
use Drupal\Core\Session\AccountInterface;

/**
 * Provides a 'Demo' block.
 *
 * @Block(
 *   id = "demo_block",
 *   admin_label = @Translation("Demo block"),
 * )
 */

class DemoBlock extends BlockBase {

  /**
   * {@inheritdoc}
   */
  public function build() {
    return array(
      '#markup' => $this->t('Hello World!'),
    );
  }

  /**
   * {@inheritdoc}
   */
  public function access(AccountInterface $account) {
    return $account->hasPermission('access content');
  }

}

그런 다음 $ 양식을 반환 할 수 있습니다. 이는 양식의 렌더링 가능한 배열입니다.

결론

이 기사에서는 Drupal 8 모듈 개발을 계속 탐색하고 두 가지 새로운 주제, 즉 블록 및 양식을 소개합니다. 우리는 UI에서 블록을 만드는 데 사용할 수있는 자체 블록 유형을 만드는 방법을 배웠습니다. 또한 사용자 정의 구성을 추가하고 나중에 사용하기 위해 값을 저장하는 방법을 배웠습니다. 양식과 관련하여, 우리는 사용자가 제출 한 값을 화면에 인쇄하는 데 사용하는 Formbase 클래스의 간단한 구현을 보았습니다. 다음 자습서에서는 구성 양식에 대해 빠르게 배울 것입니다. Drupal 8 구성 시스템을 사용하여 사용자 제출 값을 저장합니다. 또한 서비스 컨테이너 및 종속성 주입 및 Drupal 8에서의 작동 방식에 대해 배울 것입니다. 그럼 보자.

Drupal 8 모듈 구축에 대해 자주 묻는 질문 : 블록 및 양식 (FAQ) Drupal 8 모듈의 기본 구조는 무엇입니까?

Drupal 8 모듈은 본질적으로 특정 기능을 포함하는 파일 세트이며 PHP로 작성됩니다. Drupal 8 모듈의 기본 구조에는 .info.yml 파일, .Module 파일 및 .css, .js, .twig 등과 같은 기타 옵션 파일이 포함됩니다. .info.yml 파일은 모듈의 이름, 설명, 패키지, 유형 및 핵심 호환성을 나열하는 데 사용됩니다. .Module 파일은 실제 PHP 코드가있는 곳입니다.

Drupal 8에서 사용자 정의 블록을 만드는 방법은 무엇입니까?

Drupal 8에서 사용자 정의 블록 생성에는 새 사용자 정의 모듈을 작성하고 블록 플러그인을 정의하는 것이 포함됩니다. 블록 플러그인은 블록의 속성과 메소드를 정의하는 PHP 클래스 파일입니다. 모듈의 "SRC/플러그인/블록"디렉토리에 배치해야합니다. 블록 플러그인 클래스는 "블록베이스"클래스를 확장하고 "build ()"메소드를 구현하여 렌더링 가능한 블록 컨텐츠 배열을 반환해야합니다.

Drupal 8에서 사용자 정의 양식을 만드는 방법은 무엇입니까?

Drupal 8에서 사용자 정의 양식을 작성하려면 새 사용자 정의 모듈을 만들고 양식 클래스를 정의하는 것이 포함됩니다. 양식 클래스는 양식의 속성과 방법을 정의하는 PHP 클래스 파일입니다. 모듈의 "SRC/Form"디렉토리에 배치해야합니다. 양식 클래스는 "formbase"클래스를 확장하고 "getformid ()", "buildform ()"및 "downform ()"의 세 가지 방법을 구현해야합니다. "buildform ()"메소드는 양식 배열을 반환하고 "downform ()"메소드는 양식 제출을 처리합니다. Drupal 8 사이트의 특정 영역에 블록을 표시하는 방법은 무엇입니까? Drupal 8 사이트의 특정 영역에 블록을 표시하려면 관리 인터페이스의 블록 레이아웃 페이지로 이동해야합니다. 여기에서는 주제의 모든 영역에 블록을 할당 할 수 있습니다. 경로, 컨텐츠 유형, 사용자 역할 등을 기반으로 블록의 가시성 설정을 구성 할 수도 있습니다.

Drupal 8 사용자 정의 양식의 입력을 확인하는 방법은 무엇입니까?

Drupal 8 사용자 정의 양식에 입력을 확인하려면 양식 클래스에서 "validateform ()"메소드를 무시할 수 있습니다. 양식을 제출할 때이 메소드는 "제출 형식 ()"메소드 전에 호출됩니다. "validateform ()"메소드에서 유효성 검사 로직을 추가하고 "seterror ()"메소드를 호출하여 양식 요소에 대한 오류 메시지를 설정할 수 있습니다 (유효성 검사 실패).

Drupal 8에서 기존 양식을 변경하는 방법은 무엇입니까?

Drupal 8에서 기존 양식을 변경하려면 모듈에서 "hook_form_form_id_alter ()"함수를 구현할 수 있습니다. 이 기능은 양식을 작성할 때 호출되므로 양식 배열을 수정할 수 있습니다. "form_id"는 변경하려는 양식의 ID로 교체해야합니다.

Drupal 8에서 프로그래밍 방식으로 양식을 제출하는 방법은 무엇입니까?

Drupal 8에서 양식을 프로그래밍 방식으로 제출하려면 양식 클래스의 인스턴스를 작성하고 "downform ()"메소드를 호출 할 수 있습니다. 그러나이 방법을 호출하기 전에 양식 상태 객체를 준비하고 양식 요소의 값을 설정해야합니다.

Drupal 8에서 구성 양식을 만드는 방법은 무엇입니까?

Drupal 8에서 구성 양식을 작성하려면 "Formbase"클래스 대신 "ConfigFormBase"클래스를 확장하는 양식 클래스를 정의 할 수 있습니다. "configformbase"클래스는 "getEditableConFignames ()"및 "config ()"와 같은 구성 데이터를 처리하기위한 다른 메소드를 제공합니다. 구성 데이터는 Drupal 구성 시스템에 저장되며 코드의 어느 곳에서나 액세스 할 수 있습니다.

Drupal 8에서 다단계 양식을 만드는 방법은 무엇입니까?

Drupal 8에서 다중 단계 양식을 만들려면 FormStateInterface 객체를 사용하여 단계간에 데이터를 저장할 수 있습니다. "buildform ()"메소드에서 양식 상태의 현재 단계를 확인하고 각 단계마다 다른 양식 배열을 반환 할 수 있습니다. "submital ()"메소드에서 현재 단계를 확인한 다음 데이터를 저장 한 다음 다음 단계로 이동하거나 최종 커밋을 처리 할 수 ​​있습니다.

Drupal 8에서 Ajax 양식을 만드는 방법은 무엇입니까?

Drupal 8에서 ajax 양식을 만들려면 "buildform ()"메소드의 양식 요소에 "#ajax"속성을 추가 할 수 있습니다. 이 속성은 요소가 트리거 될 때 호출 할 콜백 함수를 지정하는 배열이어야합니다. 콜백 함수는 업데이트 할 양식의 일부 또는 AJAX 명령 세트를 반환해야합니다.

이 개정 된 출력은 원래 이미지 형식과 배치를 유지하면서 FAQS 섹션을 반복하지 않고 합리적인 길이를 유지하기 위해 크게 압축되었습니다.

위 내용은 Drupal 8 모듈 구축 : 블록 및 양식의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!