Your Entity, Your Code
•
0 j'aime•771 vues
Con la versione 7 di Drupal è stato introdotto il concetto di Entity, poi evoluto con la versione 8, utilizzato come base di buona parte degli elementi core (nodi, tassonomie, utenti, ...), ma - soprattutto - è stata data la possibilità di costruire entity custom. L'utilizzo di queste apre le possibilità di personalizzazione dello strumento ad un livello superiore velocizzando notevolmente lo sviluppo. Verranno mostrate le potenzialità nell'uso delle Entity custom e le integrazioni possibili.
Recommandé
Contenu connexe
Tendances
Tendances (20)
En vedette
En vedette (20)
Similaire à Your Entity, Your Code
Similaire à Your Entity, Your Code (20)
Plus de Marco Vito Moscaritolo
Plus de Marco Vito Moscaritolo (9)
Dernier
Dernier (20)
Your Entity, Your Code
- 2. Your Entity Your Code Marco Vito Moscaritolo @mavimo@gmail.com
- 3. me.yml users: mavimo: name: Marco Vito Moscaritolo email: mavimo-at-gmail.com twitter: @mavimo technologies: [ php, drupal, symfony ] role: [ developer, teacher, architect ] work: freelance founder: @sparkfabrik
- 5. …right?
- 6. • D6 & 5 $node = new stdClass(); // Sad L • D7 $node = new stdClass(); // DrupalEntityControllerInterface // EntityFieldQuery, … • D8 $node = new DrupalnodeEntityNode(); // Yah yahhhh!!! J A bit of history
- 7. • Entity (Node, User, Comment, Taxonomy, …) • Bundle (Node type, Vocabularies, …) • Property (Node id, node title, vocabulary name, …) • Field (Body, Image field, Term references, …) Core elements
- 8. D7 - hook_entity_info() return array( ’entity_name' => array( 'label' => t(’Custom entity'), 'controller class' => ’CustomEntityController', 'base table' => ’custom_entity', 'uri callback' => ’custom_entity_uri', 'fieldable' => TRUE, 'entity keys' => array( /* ... */ ) 'bundle keys' => array( 'bundle' => 'machine_name', ), 'bundles' => array( /* ... */ ), 'view modes' => array( /* ... */ ), ), );
- 9. D7 - Entity API
- 10. D7 - Entity Bla bla… class CustomEntity extends Entity { public function __construct(array $values = [], $entity_type = NULL) {} public function identifier() {} public function bundle() {} public function uri() {} public function hasStatus($status) {} public function save() {} public function delete() {} public function view($view_mode = 'full', $lang = NULL, $page = NULL) {} public function buildContent($view_mode = 'full', $langcode = NULL) {} // ... }
- 11. D7 - hook_entity_info() extended by Entity API return array( ’entity_name' => array( // ... ’entity class' => ’CustomEntity', // ... 'views controller class' => ’CustomEntityViewsController', // ... 'exportable’ => TRUE, // ... 'admin ui' => array( // ... 'controller class' => ’CustomEntityUIController', ), ), );
- 12. D7 - EntityAPIController class CustomEntityController extends EntityAPIController { public function __construct($entityType) {} public function query($ids, $conditions, $revision_id = FALSE) {} public function load($ids = array(), $conditions = array()) {} public function invoke($hook, $entity) {} public function delete($ids, DatabaseTransaction $trans = NULL) {} public function save($entity, DatabaseTransaction $trans = NULL) {} public function create(array $values = array()) {} public function buildContent($entity, $view_mode = 'full’, $lang = NULL, $content = []) {} public function view($entities, $view_mode = 'full’, $langcode = NULL, $page = NULL) {} // ... }
- 13. D7 - EntityDefaultUIController Bla bla…class CustomEntityUIController extends EntityDefaultUIController { public function __construct($entity_type, $entity_info) {} public function hook_menu() {} public function hook_forms() {} public function overviewTable($conditions = array()) {} public function overviewForm($form, &$form_state) {} public function operationForm($form, &$form_state, $entity, $op) {} // and also [overview|operation]Form[Submit|Validate] methods. public function applyOperation($op, $entity) {} // ... }
- 17. Too much work… why??? Integration view, rules, features Code testability easy to isolate Reusability code once, use more Remote entity social network, webservices Drupal 8 ;-)
- 19. EntityFieldQuery $query = new EntityFieldQuery(); $query->entityCondition('entity_type', 'custom_entity') ->entityCondition('bundle', 'my_bundle') ->propertyCondition('uid', $user->uid, '=') ->fieldCondition('field_faculty_tag', 'tid', 10) ->fieldOrderBy('field_faculty_tag', 'tid', 'DESC') ->range(0, 10); $result = $query->execute(); if (isset($result['custom_entity'])) { $items = entity_load('custom_entity’, array_keys($result['custom_entity'])); }
- 20. EntityMetadataWrapper $wrapper = entity_metadata_wrapper('custom_entity', $entity); $wrapper->author->mail->set('demo@drupalday.it'); $wrapper->description->value('This is a demo!'); $labels = array(); foreach ($wrapper->field_faculty_tag->getIterator() as $delta => $term_wrapper) { $labels[] = $term_wrapper->label->value(); } $wrapper->save();
- 21. D7 - Create Custom Entity… Fast!(1) drush entity-scaffold entity_name dday File dday/entity_name/includes/entity_name.admin.inc created. [ok] File dday/entity_name/includes/entity_name.class.inc created. [ok] File dday/entity_name/includes/entity_name.controller.inc created. [ok] File dday/entity_name/includes/entity_name.type.controller.inc created. [ok] File dday/entity_name/includes/entity_name_type.admin.inc created. [ok] File dday/entity_name/entity_name.info created. [ok] File dday/entity_name/entity_name.install created. [ok] File dday/entity_name/entity_name.tpl.php created. [ok] File dday/entity_name/entity_name.module created. [ok] https://www.drupal.org/project/entity_scaffold
- 23. …Drupal 8 ?
- 24. Thanks!
- 26. D8 - Entity Type Module namespaced Drupalmy_moduleEntityMyCustomeEntity() Defined folder in module src/Entity/MyCustomEntity.php INFORMATION MANAGED BY ANNOTATION /** * @XyzEntityType( … ) */ Can be “code only” config/install/my_custom_entity.sample_1.yml Unit testable class MyCustomEntityTest extends DrupalTestsUnitTestCase {}
- 27. D8 - ContentEntityType Require database definition hook_schema() Can be fildable/REVISIONABLE baseFieldDefinition() CAN HAVE CUSTOM BEHAVIOR redefine [pre|post][Save|Load|Delete] methods CAN PROVIDE CUSTOM ACCESS RULES checkAccess() and checkCreateAccess() CAN PROVIDE CUSTOM HANDLERS strorage, view_builder, route_provider, form, translation, config_export...
- 28. D8 - ContentEntityType /** * @ContentEntityType( * id = "my_content", * label = @Translation("My Content"), * bundle_label = @Translation("My Content type"), * handlers = { ... }, * base_table = "my_entity", * data_table = "my_entity_field_data", * revision_table = "my_entity_revision", * revision_data_table = "my_entity_field_revision", * translatable = TRUE, * entity_keys = { ... }, * bundle_entity_type = "my_entity_type", * field_ui_base_route = "entity.my_entity_type.edit_form", * common_reference_target = TRUE, * permission_granularity = "bundle", * links = { ... } * ) */ class MyContentEntity extends ContentEntityBase implements MyContentEntityInterface { }
- 29. D8 - ConfigEntityType Difference compared to ContentEntityType: • Schema file definition Instead of database schema definition, using: config/schema/my_entity.schema.yml • INTEGRATED with CMI API for exportability See dedicated talk. • No field
- 30. D8 - ConfigEntityType /** * @ConfigEntityType( * id = "my_config", * label = @Translation("My config"), * handlers = { * "list_builder" = "Drupalmy_moduleControllerMyConfigListBuilder", * "form" = { ... } * }, * config_prefix = "my_config", * admin_permission = "administer site configuration", * entity_keys = { ... }, * links = { ... } * ) */ class MyConfigEntity extends ConfigEntityBase implements MyConfigEntityInterface { ... }
- 31. my_module/config/schema/my_config.schema.yml my_module.my_config.*: type: config_entity label: My config’ mapping: id: type: string label: 'ID’ label: type: label label: 'Label'
- 32. D8 - Create Custom Entity… Fast! drupal generate:entity:content --module=dday --entity-name=my_content_entity --entity-class=MyContentEntity --label="My Content Entity” Generated or updated files Site path: ~/dday 1 - modules/custom/dday/dday.routing.yml 2 - modules/custom/dday/dday.permissions.yml 3 - modules/custom/dday/dday.links.menu.yml 4 - modules/custom/dday/dday.links.task.yml . . . 13 - modules/custom/dday/src/Entity/Form/MyContentEntityDeleteForm.php 14 - modules/custom/dday/my_content_entity.page.inc 15 - modules/custom/dday/templates/My Content Entity.html.twig https://www.drupal.org/project/console