Hasta ahora no había tenido que hacer entidades desde cero, por A o por B siempre voy por otros caminos, pero hoy si que me tocó hacer una y vi bastante difusas las cosas.
Sabia la teoría de lo que era una entidad, un bundle y esas cosas, pero cuando me tuve que poner a hacer la entidad me las vi crudas un buen rato.

El problema se me dio básicamente en que los tutoriales y documentación que hay por ahí se centran en mostrar todo lo que se puede hacer de una sola vez, y bueno… no soy tan listo, me perdía en el código.

Pero ahora lo veo un poco mas claro y quiero explicarlo de la forma que me hubiera gustado que me lo transmitieran.

Voy a explicar en dos o tres artículos lo que hace falta saber sobre la implementacion de una entidad usando Entity API y tratando de aclarar bien bien donde acaba una funcionalidad y comienza otra.

Vamos allá.

Lo primero es lo primero. Estas leyendo esto posiblemente porque querés hacer entidades y entiendo que ya hiciste los deberes y conoces los conceptos básicos así que no los voy a explicar. En su lugar vamos a aprender haciendo mini módulos que implementen las distintas funcionalidades.

Creemos una entidad

Para crear una entidad solo necesitas dos cosas:

1. Es schema (futura tabla en la DB) para guardar los datos mínimos y necesarios y cualquier otro dato que quieras que esté relacionado a las entidades que estas creando.
2. Informar a Drupal que ese schema lo tiene que entender como una entidad.

TIP: Programaticamente hablando una entidad es un objeto. Eso es, nada mas que un objeto. No te preocupes de que tipo es, solo tenes que saber eso, que es un objeto.
Este objeto tiene una capa de persistencia que es el schema. De ahí que solo haga falta definir un schema e informar al sistema sobre la nueva entidad.

TIP2: Otra cosa que me descolocó hasta que me di cuenta de lo que acabo de comentar el el tip anterior es que: una entidad es un concepto abstracto y que las instancias (los objetos creados a partir de esa entidad) son los objetos reales y “tangibles”. Estas instancias son las que van a parar a la DB. Luego existen también los bundles pero ya nos vamos a complicar la vida con ese concepto en el próximos artículos.

Volviendo al tema:

Schema:

El schema no tiene nada de especial, lo único que necesita para funcionar es el identificador único para esta entidad (Compara esto al uid de un usuario, el nid de un nodo, etc.) y un field cualquiera ^*1.
Entonces, si necesitáramos una entidad mega simple, nuestro schema se vería así:

<?php
function entidad_simple_schema() {
  $schema['nombre_de_la_tabla'] = array(
    'description' => 'Almacena instancias de la entidad',
    'fields' => array(
      'entityID' => array(
        'type' => 'serial',
        'not null' => TRUE,
        'description' => 'Identidicador unico de esta entidad.',
      ),
      'nombre' => array(
        'description' => 'Nombre de la instancia',
        'type' => 'varchar',
        'length' => 100,
        'not null' => TRUE,
        'default' => '',
      ),
    ),
    'primary key' => array('entityID'),
  );
  return $schema;
}

Informar a Drupal:

Para terminar de crear la entidad vamos a informar a Drupal usando el hook_entity_info()

<?php
function entidad_simple_entity_info() {
  $return = array(
    'laEntidad' => array(
      'label' => t('La entidad'),
      'controller class' => 'EntityAPIController',
      'base table' => 'nombre_de_la_tabla',
      'entity keys' => array('id' => 'entityID'),
    ),
  );
  return $return;
}

Ese codigo que acabo de poner es la unidad mínima de información que necesita este hook para crear correctamente tu entidad.
Este array es bastante claro:

Acá te dejo el código anterior metido en un modulo para que lo pruebes.

Descargar ejemplo

Aquí concluimos este articulo, el próximo vamos a hacer un modulo que haga algo con la entidad que acabamos de crear, que este modulo por si solo no hace nada.

Chau!

*1: El field cualquiera es porque internamente cuando se hace un drupal_write_record() si no tiene aunque sea un field, descarta la operación ¬¬. En este ejemplo hice un field llamado “nombre” que nos va a venir bien.