Drupal Entities - PHP Class per bundle

Thu, 17 Apr 2014 11:18:08 +0000

If you would like a bit more polymorphism in your drupal entities, this might cheer you up :-D

I was looking for a way to have a class hierarchy that matched the bundle “hierarchy” of entities in drupal. Yes, they are all “subclasses” of ONE parent, but it is still useful to be able to have a class per bundle.

The entity bundle plugin does a good job of providing a plugin framework to instantiate classes per bundle type. There is also an example of how to use this. However, this was a bit of overkill for me. I did however borrow the idea (and some code) to implement it in a simpler fashion.

Implement a custom controller and override the create and the query methods

```phg class MyEntityAPIController extends EntityAPIController { /** * Overrides EntityAPIController::query(). */ public function query($ids, $conditions, $revision_id = FALSE) { $query = $this->buildQuery($ids, $conditions, $revision_id); $result = $query->execute(); $result->setFetchMode(PDO::FETCH_ASSOC); // Build the resulting objects ourselves, since the standard PDO ways of // doing that are completely useless. $objects = array(); foreach ($result as $row) { $row['is_new'] = FALSE; $objects[] = $this->create($row); } return $objects; } /** * Overrides EntityAPIController::create(). */ public function create(array $values = array()) { if (!isset($values[$this->entityInfo['entity keys']['bundle']])) { throw new Exception(t('No bundle provided to MyEntityAPIController::create().')); } $bundle = $values[$this->entityInfo['entity keys']['bundle']]; // Add is_new property if it is not set. $values += array( 'is_new' => TRUE, ); $default_class = isset($this->entityInfo['entity class']) ? $this->entityInfo['entity class'] : NULL; $class = isset($this->entityInfo['bundles'][$bundle]['entity class']) ? $this->entityInfo['bundles'][$bundle]['entity class'] : $default_class; if (!class_exists($class)) { $class = "Entity"; } return new $class($values, $this->entityType); } } ```

I can now define a PHP class for each bundle as follows in hook_entity_info

```php $entity['myentity'] = array( 'label' => t('myentity'), 'module' => 'mymodule', 'entity class' => 'MyEntity', // Default entity class if not defined in bundle 'controller class' => 'MyEntityAPIController', 'base table' => 'myentity', 'entity keys' => array( 'id' => 'id', 'label' => 'name', 'bundle' => 'bundle', ), 'bundles' => array( 'bundle1' => array( 'label' => 'Bundle 1', 'entity class' => 'Bundle1Entity', ), 'bundle2' => array( 'label' => 'Bundle 2', 'entity class' => 'Bundle2Entity', ), ), ```

Don’t forget to clear the cache and you should be able to get bundle specific classes instantiated. It will fall back to the ’entity class’ defined for the entity if the bundle ’entity class’ is not defined or cannot be found.

hook_theme doesn't get called

Tue, 22 Feb 2011 20:20:11 +0000

I was developing a new module in drupal and it needed a theme function to be implemented.

As per the instructions, it was implemented as follows (to use a template)

```phg /** * Implementation of hook_theme(). */ function my_module_results_theme($existing, $type, $theme, $path) { return array( 'my_block' => array( 'template' => 'my_block', 'arguments' => array( 'var1' => NULL ) ) ); } ```

However, when trying to apply the theme, it didn’t work. I tried various things and identified that the hook above was just not being called. A little bit of digging helped me discover that themes are cached. This happens even in the dev mode. To resolve this, go to

Administer -> Performance -> Clear Cached Data (right at the bottom of the page)

and et voila my theme was now being utilised.

Php on despatches

Drupal Entities - PHP Class per bundle

hook_theme doesn't get called