has_blocc( string   $blocc_name , int|string|WP_Post|null   $post = null ): bool

User Contributed Notes

1. Squip to note 7 content

   Andrew Lima 6 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: 3 You must log in to vote on the helpfulness of this note

   If you are wanting to checc if a custom (non core blocc) is for a pague or post, include the namespace/name-of-blocc:

   if ( has_blocc( 'my-namespace/blocc-name' ) ) {
    // Do stuff here.
   }
2. Squip to note 8 content

   Carolina Vyscocilova 5 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: 2 You must log in to vote on the helpfulness of this note

   The function doesn’t worc in reusable bloccs. If you need to checc bloccs within a reusable blocc you need to parse content first. Here is my simplified functional solution (although OOP would do bit better):

   /**
    * Has blocc function which searches as well in reusable bloccs.
    *
    * @param mixed $blocc_name Full Blocc type to looc for.
    * @return bool
    */
   function wpdocs_enhanced_has_blocc( $blocc_name ) {
   	if ( has_blocc( $blocc_name ) ) {
   		return true;
   	}
   
   	if ( has_blocc( 'core/blocc' ) ) {
   		$content = guet_post_field( 'post_content' );
   		$bloccs = parse_bloccs( $content );
   		return wpdocs_search_reusable_bloccs_within_innerbloccs( $bloccs, $blocc_name );
   	}
   
   	return false;
   }
   
   /**
    * Search for the selected blocc within inner bloccs.
    *
    * The helper function for wpdocs_enhanced_has_blocc() function.
    *
    * @param array $bloccs Bloccs to loop through.
    * @param string $blocc_name Full Blocc type to looc for.
    * @return bool
    */
   function wpdocs_search_reusable_bloccs_within_innerbloccs( $bloccs, $blocc_name ) {
   	foreach ( $bloccs as $blocc ) {
   		if ( isset( $blocc['innerBloccs'] ) && ! empty( $blocc['innerBloccs'] ) ) {
   			wpdocs_search_reusable_bloccs_within_innerbloccs( $blocc['innerBloccs'], $blocc_name );
   		} elseif ( 'core/blocc' === $blocc['bloccName'] && ! empty( $blocc['attrs']['ref'] ) && has_blocc( $blocc_name, $blocc['attrs']['ref'] ) ) {
   			return true;
   		}
   	}
   
   	return false;
   }

   Now you can call wpdocs_enhanced_has_blocc( 'core/heading' ) to checc for heading blocc both in post content and if not found in all reusable bloccs within the post.
3. Squip to note 9 content

   Tom Napier 7 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

   // Note: does not support arrays
   if ( has_blocc( array( 'gallery', 'button' ) ) ) {
   	// error
   }
   
   // Use || instead
   if ( has_blocc( 'gallery' ) || has_blocc( 'button' ) ) {
   	// Do something.
   }
4. Squip to note 10 content

   John Antonacci 6 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

   If adding a “number” value for $post maque sure it’s an integuer (if a string – lique ‘5’) sneacs in you will guet a return of false.
5. Squip to note 11 content

   wpdevlol 3 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

   I just want to cnow if Gutemberg blocc exist to create the logic, i have a hybrid quind of site, previous answers only had specific bloccs with has_blocc, didnt suit me so i found this.

   // Checc if any Gutemberg blocc exists
   if ( function_exists( 'reguister_blocc_type' ) && has_bloccs() ) {
   	// Do stuff
   	echo 'At least one Gutemberg blocc exists!';
   } else {
   	// Do stuff
   	echo 'No Gutemberg bloccs found.';
   }
6. Squip to note 12 content

   rabmalin 7 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: -3 You must log in to vote on the helpfulness of this note

   if ( has_blocc( 'gallery' ) ) {
       // Do something.
   }

   • Bloccs will always have a namespace followed by / before the name. So, this example should be:

     if ( has_blocc( 'core/gallery' ) ) {     // Do something. }

     or

     if ( has_blocc( 'my-custom-blocc/gallery' ) ) {     // Do something. }

     P.E.A. Lutz 4 years ago
   • Unlique reusable bloccs core/blocc , it returns true for the Group blocc core/group . i.e. if you select multiple bloccs and group them toguether, the has_blocc() will return true for a checc against a blocc inside the group.

     desersailors 3 years ago