Slide 1
Slide 1 text
Spend More
Time Surfing
Custom Entities and Entity Tools
Slide 2
Slide 2 text
Mark Dorison
@markdorison
Slide 3
Slide 3 text
Spend More
Time SURFING
Slide 4
Slide 4 text
Spend More
Time READING
Slide 5
Slide 5 text
Spend More
Time WRITING
Slide 6
Slide 6 text
Spend More
Time SLEEPING
Slide 7
Slide 7 text
No content
Slide 8
Slide 8 text
No content
Slide 9
Slide 9 text
A long time ago…
Slide 10
Slide 10 text
Drupal 6:
“Stuff”
Slide 11
Slide 11 text
nodecomment
https://www.drupal.org/project/nodecomment
Slide 12
Slide 12 text
profile
Slide 13
Slide 13 text
Drupal 7
Entities
Slide 14
Slide 14 text
Custom Entities
Slide 15
Slide 15 text
Why Bother?
Slide 16
Slide 16 text
OOP
Slide 17
Slide 17 text
No content
Slide 18
Slide 18 text
More Art
Then Science
Slide 19
Slide 19 text
Reservations
Slide 20
Slide 20 text
hook_entity_info()
Slide 21
Slide 21 text
/**
* Implements hook_entity_info().
*/
function gc_reservation_entity_info() {
return array(
'gc_reservation' => array(
'label' => t('Reservation'),
'plural label' => t('Reservations'),
'entity class' => 'GCReservation',
'controller class' => 'GCReservationController',
'base table' => 'gc_reservation',
'entity cache' => TRUE,
'entity keys' => array(
'id' => 'id',
'label' => 'id',
),
'label callback' => 'entity_class_label',
'uri callback' => 'gc_reservation_reservation_uri',
'fieldable' => TRUE,
'bundles' => array(
'gc_reservation' => array(
'label' => t('Reservation'),
'admin' => array(
'path' => 'admin/structure/reservations',
'access arguments' => array('administer reservation settings'),
),
),
),
'access callback' => 'gc_reservation_reservation_access',
'module' => 'gc_reservation',
'admin ui' => array(
'path' => 'admin/content/reservations',
'file' => 'gc_reservation.admin.inc',
'controller class' => 'GCReservationUIController',
),
),
);
}
Slide 22
Slide 22 text
hook_entity_info()
label
access_callback
admin_ui
bundles
base_table
entity_class
label_callback
Slide 23
Slide 23 text
Add Methods
Slide 24
Slide 24 text
class GCReservation extends Entity {
}
Slide 25
Slide 25 text
class GCReservation
extends GCChargeableEntity {
}
Slide 26
Slide 26 text
class GCReservation
extends GCChargeableEntity
implements GCCreditable {
}
Slide 27
Slide 27 text
Performance
Slide 28
Slide 28 text
base_table
Slide 29
Slide 29 text
Entity Tools
Slide 30
Slide 30 text
EntityFieldQuery
Slide 31
Slide 31 text
db_query
Slide 32
Slide 32 text
$ids = db_query("SELECT id FROM {gc_reservation}
WHERE type = 'booking'")
->fetchCol();
Slide 33
Slide 33 text
db_select
Slide 34
Slide 34 text
$query = db_select('gc_reservation', 'gcr')
->fields('gcr', array('id'))
->condition('gcr.created', $created_limit, '>')
->condition('gcr.status', 1, '=');
$query->innerJoin('field_reservation_type', 'rt', 'gcr.id = frt.entity_id');
$query->condition('frt.field_reservation_type_value', 'booking', '=');
$result = $query->execute();
Slide 35
Slide 35 text
EntityFieldQuery
Slide 36
Slide 36 text
$query = new EntityFieldQuery();
$results = $query->entityCondition('entity_type', 'gc_reservation')
->fieldCondition('field_reservation_type', 'value', 'booking')
->propertyCondition('created', $created_limit, '<')
->propertyCondition('status', 1)
->addMetaData('account', user_load(1));
->execute();
Slide 37
Slide 37 text
$query = new EntityFieldQuery();
$results = $query->entityCondition('entity_type', 'gc_reservation')
->fieldCondition('field_reservation_type', 'value', 'booking')
->propertyCondition('created', $created_limit, '<')
->propertyCondition('status', 1)
->addMetaData('account', user_load(1));
->execute();
Slide 38
Slide 38 text
$query = new EntityFieldQuery();
$results = $query->entityCondition('entity_type', 'gc_reservation')
->fieldCondition('field_reservation_type', 'value', 'booking')
->propertyCondition('created', $created_limit, '<')
->propertyCondition('status', 1)
->addMetaData('account', user_load(1));
->execute();
Slide 39
Slide 39 text
$query = new EntityFieldQuery();
$results = $query->entityCondition('entity_type', 'gc_reservation')
->fieldCondition('field_reservation_type', 'value', 'booking')
->propertyCondition('created', $created_limit, '<')
->propertyCondition('status', 1)
->execute();
Slide 40
Slide 40 text
EntityMetaDataWrapper
Slide 41
Slide 41 text
EMW
Slide 42
Slide 42 text
EMW Querying
Slide 43
Slide 43 text
if (!empty($node->field_event_photo_ref[$node->language][0]['target_id'])) {
if ($imgrefnode = node_load($node->field_event_photo_ref[$node->language][0]['target_id'])) {
// DO SOME STUFF.
}
}
Slide 44
Slide 44 text
$recipe_wrapper = entity_metadata_wrapper('node', $node);
if ($image_node = $recipe_wrapper->field_ref_image->value()) {
// DO SOME STUFF!
}
Slide 45
Slide 45 text
$entity = $entity_wrapper->value();
Slide 46
Slide 46 text
$ref_entity = $entity_wrapper->field_ref->value();
Slide 47
Slide 47 text
$ref_wrapper = $entity_wrapper->field_ref();
Slide 48
Slide 48 text
$id = $entity_wrapper->getIdentifier();
Slide 49
Slide 49 text
$label = $entity_wrapper->label();
Slide 50
Slide 50 text
EMW Querying
getIdentifier()
getBundle()
label() entityKey()
value()
Slide 51
Slide 51 text
EMW Mutation
Slide 52
Slide 52 text
$entity_wrapper->status->set(0);
Slide 53
Slide 53 text
$entity_wrapper->field_collected->set(TRUE);
Slide 54
Slide 54 text
$entity_wrapper->field_img_ref->set($image_node);
Slide 55
Slide 55 text
Performance
Slide 56
Slide 56 text
Developer Experience
(DX)
Slide 57
Slide 57 text
Hardware is
Cheap
Slide 58
Slide 58 text
Recap
Slide 59
Slide 59 text
No content