Drupalize your data use entities
2 likes643 views
Wolfgang Ziegler presented on using entities in Drupal. He discussed interacting with entities using functions like entity_load() and entity_save(), and providing new entity types by implementing hook_entity_info() and hook_schema(). He explained how to integrate entity types by implementing things like property info, CRUD, and controllers. Finally, he covered exposing non-database entities and improvements planned for Drupal 8.
![Metadata Wrapper
$wrapper = entity_metadata_wrapper('node', $nid);
$mail = $wrapper>author>mail>value();
$wrapper>author>mail>set('fago@example.com');
$text = $wrapper>field_text>value();
$wrapper>language('de')>field_text>value();
$terms = $wrapper>field_tags>value();
$wrapper>field_tags[] = $term;
$options = $wrapper>field_tags>optionsList();
$label = $wrapper>field_tags[0]>label();
$access = $wrapper>field_tags>access('edit');](https://image.slidesharecdn.com/drupalizeyourdatauseentities-130530025957-phpapp01/85/Drupalize-your-data-use-entities-14-320.jpg)
![Metadata Wrapper
$wrapper = entity_metadata_wrapper('node', $nid);
$mail = $wrapper>author>mail>value();
$wrapper>author>mail>set('fago@example.com');
$text = $wrapper>field_text>value();
$wrapper>language('de')>field_text>value();
$terms = $wrapper>field_tags>value();
$wrapper>field_tags[] = $term;
$options = $wrapper>field_tags>optionsList();
$label = $wrapper>field_tags[0]>label();
$access = $wrapper>field_tags>access('edit');](https://image.slidesharecdn.com/drupalizeyourdatauseentities-130530025957-phpapp01/85/Drupalize-your-data-use-entities-15-320.jpg)
![Entity property info
$properties['mail'] = array(
'label' => t("Email"),
'type' => 'text',
'description' => t("The email address of ..."),
'setter callback' => 'entity_property_verbatim_set',
'validation callback' => 'valid_email_address',
'required' => TRUE,
'access callback' => 'user_properties_access',
'schema field' => 'mail',
);](https://image.slidesharecdn.com/drupalizeyourdatauseentities-130530025957-phpapp01/85/Drupalize-your-data-use-entities-16-320.jpg)
Drupalize your data use entities
- 3. Wolfgang Ziegler // fago • from Vienna, Austria • studied at the TU Vienna • Drupal since 2005. wolfgangziegler.net twitter.com/the_real_fago gplus.to/fago
- 4. Outline • Introduction • Interact with entities • Providing a new entity type • Expose non-DB entities • Outlook
- 6. Bundles Entity type ↔ Node Bundle ↔ Node type Entity type ↔ Taxonomy term Bundle ↔ Vocabulary Entity type ↔ User Bundle ↔ {}
- 7. Which entities are there? • Core • Modules: • Drupal commerce • Organic groups • Profile2 • Heartbeat and Message • File entity
- 9. Entity API - What for? Unified way to access data.
- 12. Entity API module Assists you with • interacting with entities • and providing new entity types
- 13. Entity API Functions Drupal Core Entity API module entity_save() entity_load() entity_get_info() entity_metadata_wrapper() entity_view() entity_access() entity_create() entity_id() entity_get_property_info() entity_delete()
- 17. Property info? • Unified access to entity data • Validation • Access information
- 18. How modules use it • Drupal Commerce, VBO, OG • Rules, Search API • Microdata • RestWS, WSClient • Entity tokens • Entity Views
- 19. Providing an entity type • Implement hook_entity_info() • Specify your 'controller class' • Implement hook_schema()
- 21. Integrating your entity type TokensViews Rules Property Info Field API Schema CRUD controller Info XY
- 22. Exportable entities similar to CTools exportables, but... • unified CRUD interface • synced to the DB • regular CRUD hooks • Views, Tokens, Features, i18n, ...
- 23. Integrating your exportable entity Schema CRUD controller Info Tokens Property Info Views i18nFeatures Admin UI
- 24. Apocalypse now? • Provide an entity • get a bullshit of not fitting stuff • • Find a good metafa, or cite for it. • is it an elephant or moskito?
- 25. Module developers: Think • what makes it applicable? • label, URI? • field? • custom on,off • example: no display,no page → no metadata tags
- 27. Example: Profile2 Profile2: • Entity type Profile2 types: • Entity type • Bundle of Profile2 • Exportable
- 28. Profile2 torn apart • CRUD, Field API • Permissions, Access • Profile form, display • Admin UI, I18n • Views, CTools, Rules, Tokens, Features, Search API Your job
- 29. homework done, let's enjoy it.
- 30. • NoSQL, Doctrine, PHPCR • Remote entities • Data integration
- 32. Non-DB entities Field storage Info Property Info Field API SchemaControllerInfo TokensRulesViews XY CRUD controller
- 34. What does it buy us? • Classed CRUD API • CRUD Hooks • Tokens • Entity reference • Rules, Rules Links • Search API, Views integration, RestWS • …
- 36. howto slide?
- 37. Example...
- 41. Room for improvements • EFQ Views • Ready-only mode • Generated display • Generated form
- 42. Drupal 8
- 43. Comments in Drupal 8 $comment = entity_create('comment', array( 'nid' => $node>nid, )); $comment>save(); echo $comment>id(); $comment>delete(); entity_delete_multiple('comment', array(1, 2, 3));
- 44. Comments in Drupal 8 class CommentStorageController extends EntityDatabaseStorageController { … } class Comment extends Entity { … } class Entity implements EntityInterface { … }
- 45. Questions?