사용자 정의 규칙 액션 드루팔 호스팅

규칙을 호환 작업을 정의합니다.

이 후크는 새로운 규칙의 작업을 추가하기 위해 필요합니다. 그것은 후크가 호출 될 때 자동으로 포함됩니다 파일 MODULENAME.rules.inc로 배치해야합니다.

반환 값

모듈의 제공 규칙 작업에 대한 정보의 배열입니다. 배열은 키로서 작용 이름 각 행동의 서브 어레이를 포함한다. 작업 이름에는 소문자 영숫자 문자와 밑줄을 포함 할 수 있으며, 제공하는 모듈 이름 붙여야한다. 각 하위 배열에 대한 가능한 속성은 다음과 같습니다

사용자 정의 규칙은 액션 드루팔 호스팅 배열은 다음을 포함 할 수 있습니다
  • 상표. 작업의 레이블입니다. 시작은 대문자로. 필요합니다.
  • 그룹. 인터페이스에서 작업을 그룹화에 사용이 요소의 그룹입니다. 대문자로 시작해야하고 번역. 필요합니다.
  • 매개 변수입니다. 키로서 상기 파라미터의 이름과 동작의 모든 파라미터를 설명하는 배열 (옵션). 파라미터 이름 소문자 유효 PHP 변수 명 있어야하는 반면, 나중에 설명한 바와 같이 각 파라미터 가능 속성 서브 어레이에 의해 설명한다.
  • 제공합니다. (선택) 동작 키와 변수 이름 평가 상태로 제공하는 변수를 설명하는 배열. 파라미터 이름 소문자 유효 PHP 변수 명 있어야하는 반면, 나중에 설명 각 변수는 가능한 속성 서브 어레이에 의해 설명한다.
  • '명명 된 매개 변수'. TRUE로 설정하면 (선택 사항) 인수 키로 매개 변수 이름을 가진 하나의 배열로 전달됩니다. 이것은 PHP에서 매개 변수 이름 및 매개 변수의 수가 다를 수있는 경우에 특히 유용합니다 에뮬레이트합니다. FALSE 기본값.
  • 베이스. 액션 구현 콜백 (옵션) 기본 대신 액션의 이름으로 사용합니다. 작업 이름 기본값.
  • 콜백. 동작을 위해 특정 기능 콜백을 설정할 수 있도록 배열 (옵션). 각 콜백의 기본값은 '_'와 콜백 이름으로 추가 조치 기지이다.
  • '액세스 콜백'. (선택 사항)는 현재 로그인 한 사용자 여부를 반환하는 콜백이 작업을 구성 할 수있다. 예를 들어 콜백에 대한 rules_node_integration_access ()를 참조하십시오.

각 '매개 변수'배열은 다음과 같은 속성을 포함 할 수 있습니다 :

  • 상표. 매개 변수의 레이블입니다. 시작은 대문자로. 필요합니다.
  • 유형. 인 파라미터의 규칙 데이터 타입 액션에 전달한다. hook_rules_data_info에서 선언 된 모든 종류의 () 가능한 형식의 배열뿐만 아니라, 지정 될 수있다. 또한 나열하고 지정된 유형의 목록은 기호 인 목록을 사용하여 지정할 수 있습니다 엔티티 메타 모듈에 의해 도입 된 바와 같이, hook_entity_property_info (참조). 모든 유형이 허용되어야 할 때 특수 키워드는 '*'를 사용할 수 있습니다. 필요합니다.
  • 묶음. 번들 이름의 배열 (선택 사항). 지정된 타입이 단일 엔티티 타입으로 설정되면, 이것은 허용 된 번들을 제한하는데 사용될 수있다.
  • 기술. 필요한 경우, 상기 파라미터의 상기 설명, (선택 사항).
  • 옵션 목록. 이 파라미터에 대한 가능한 값들의 어레이를 리턴한다 (선택적) 콜백. 콜백 hook_options_list 의해 사용되는 배열을 반환한다 (). 예시적인 구현에서 rules_data_action_type_options (참조).
  • 구하다. 규칙 평가가 종료 될 때 (옵션)이 TRUE로 설정하면, 매개 변수는 규칙에 의해 저장됩니다. 이것은 단지 저장 가능한 데이터 유형이 지원됩니다. 액션이 FALSE를 반환하면, 절약 건너 뜁니다.
  • 선택 과목. 매개 변수가 필요하지 않은 경우 (옵션)을, TRUE로 설정 될 수 있습니다.
  • '기본값'. 파라미터는 선택적이며 어떤 지정된 값이없는 경우에는 (선택적)의 값은, 동작에 전달한다.
  • '널 (null) 허용'. (선택 사항) 일반적으로 규칙 인수로 어떤 NULL 값을 전달하지만, NULL 값이있는 경우 평가를 중단하지 않습니다. TRUE로 설정하면, 규칙을 중단하고를 통해 NULL 값을 전달하지 않습니다. FALSE 기본값.
  • 제한. (선택 사항)이 매개 변수에 대한 인수가 제공 될 수있는 방법을 제한합니다. 지원되는 값은 '선택'와 '입력'이다.
  • 기본 모드. (옵션) 매개 변수에 대한 인수 값을 제공하는 기본 모드를 사용자 정의합니다. 지원되는 값은 '선택'와 '입력'이다. 기본값은 필요한 데이터의 유형에 따라 달라집니다.
  • 살균. (선택 사항) 유형 '텍스트'의 매개 변수가 이미 소독 인수를 요구 할 수 있습니다. 활성화 된 경우, 사용자는 지정한 값 자체를 살균되지 않지만 입력 평가자에 의해 적용될 교체는 선택된 데이터 소스로부터 검색된 값은 물론이다.
  • 번역. TRUE로 설정하면 (선택 사항), 매개 변수의 제공된 인수 값은 국제화 문자열 번역을 통해 번역입니다. 이 텍스트 매개 변수 만 입력 '텍스트'의 즉 매개 변수, '토큰', '목록에 적용'과'목록'. FALSE 기본값.
  • UI 클래스입니다. (선택적) 매개 변수의 설정 UI를 생성하는 데 사용되는 UI 클래스를 재정의 할 수 있습니다. 지정된 데이터 형의 UI 클래스에 기본.
  • 콜백을 청소. 입력 평가자 삽입 교체 청소 사용할 수 콜백 (선택 사항); 예를 들면 이것은 토큰 평가자에 의해 사용된다.
  • 감쌌다. (선택 사항) 데이터를 감싸 전달해야하는 경우에 TRUE로 설정합니다. 에만 싸서 데이터 유형, 예를 들어 적용 엔티티.
배열을 호스팅하는 사용자 정의 규칙 액션 드루팔

각각의 배열은 다음과 같은 속성을 포함 할 수있다 '제공'

  • 상표. 변수의 레이블입니다. 시작은 대문자로. 필요합니다.
  • 유형. 변수의 규칙 데이터 형식. hook_rules_data_info에서 선언 된 모든 종류의 ()를 지정할 수 있습니다. 유형은 예를 들어, 매개 변수화 할 수있다 유형 노드 또는 목록 유효합니다.
  • 구하다. 규칙 평가가 종료 될 때 (옵션)이 TRUE로 설정하면, 제공된 변수는 규칙에 의해 저장됩니다. 저장 가능한 데이터 형식 만 가능합니다. FALSE 기본값.

모듈은 키 '기지국'또는 실행 콜백 지정된라는 함수 인, 각각의 액션에 대한 구현을 제공한다. 다른 모든 가능한 콜백는 선택 사항입니다. 규칙에 의해 지원되는 액션 콜백을 정의하고 RulesPluginImplInterface에 설명되어 있습니다. 그러나 어떤 모듈 hook_rules_plugin_info하여 정의 된 인터페이스에 기초하여 상기 동작 플러그인을 연장 할 수있다 (). 이러한 인터페이스에 정의 된 모든 메소드는 액션 구현에 의해 오버라이드 (override) 할 수 있습니다. 이러한 인터페이스의 구현 콜백 hook_rules_file_info에 지정된 파일에 상주 할 수있다 ().

관련 항목

규칙을 확장하기 위해 다른 모듈에 의해 구현 될 수있는 규칙 '후크 걸이.

기여 / 규칙 / rules.api.php. 라인 137은이 파일에는 작업 PHP 코드를 포함하지 않는다; 그것은 doxygen에 대한 추가 문서를 제공 할뿐만 아니라 표준 드루팔 방식으로 후크를 문서로 존재한다.

이 비디오를 시청!

관련 기사

작업 API를 드루팔 호스팅규칙을 호환 작업을 정의합니다. 이 후크는 새로운 규칙의 작업을 추가하기 위해 필요합니다. 그것은 때 자동으로 포함됩니다 파일 MODULENAME.rules.inc로 배치해야 ...
부울 필드 타입 드루팔 호스팅드루팔 엔티티에 사용자 정의 데이터 필드를 연결합니다. 필드 API는 사용자 정의 데이터 필드 드루팔 개체에 부착 할 수 있으며, 저장 로딩, 편집 및 필드 데이터 렌더링을 담당 ....
조치 참고 배열 호스팅 워드 프레스 수행배열 인수 지정 특정 동작 후크에 걸어 기능을 실행한다. 이 함수 do_action 동일하다. 하지만 $ 태그에 걸려 함수에 전달 된 인수는 ...
필드 형 드루팔 호스팅 추가기본 제품으로. 페이지입니다. 블로그 페이지. 및 기타 콘텐츠 유형 코멘트를 남겨 방문객을위한 장소가 없습니다. 드루팔 8 년부터, 코멘트는 자신의 필드 형식이되었다. 이것은 의미 ...
드루팔 호스팅에 사용자 정의 페이지 추가경로와 해당 옵션을 선언합니다. 이 단계는 페이지 제목, 페이지에 대한 액세스 요구 사항 등이 포함되어 있습니다. 드루팔 7에서, 당신은 hook_menu 구현했다 (). 드루팔 (8)에서를 만들 ...