Chris@0: <?php
Chris@0: 
Chris@0: /**
Chris@0:  * @file
Chris@0:  * Describes hooks provided by the RESTful Web Services module.
Chris@0:  */
Chris@0: 
Chris@0: /**
Chris@0:  * @addtogroup hooks
Chris@0:  * @{
Chris@0:  */
Chris@0: 
Chris@0: /**
Chris@0:  * Alter the resource plugin definitions.
Chris@0:  *
Chris@0:  * @param array $definitions
Chris@0:  *   The collection of resource definitions.
Chris@0:  */
Chris@0: function hook_rest_resource_alter(&$definitions) {
Chris@0:   if (isset($definitions['entity:node'])) {
Chris@0:     // We want to handle REST requests regarding nodes with our own plugin
Chris@0:     // class.
Chris@0:     $definitions['entity:node']['class'] = 'Drupal\mymodule\Plugin\rest\resource\NodeResource';
Chris@0:     // Serialized nodes should be expanded to my specific node class.
Chris@0:     $definitions['entity:node']['serialization_class'] = 'Drupal\mymodule\Entity\MyNode';
Chris@0:   }
Chris@0:   // We don't want Views to show up in the array of plugins at all.
Chris@0:   unset($definitions['entity:view']);
Chris@0: }
Chris@0: 
Chris@0: /**
Chris@0:  * Alter the REST type URI.
Chris@0:  *
Chris@0:  * @deprecated in Drupal 8.3.x and will be removed before Drupal 9.0.0. Use
Chris@0:  *   hook_serialization_type_uri_alter() instead. This exists solely for BC.
Chris@0:  *
Chris@0:  * @see https://www.drupal.org/node/2830467
Chris@0:  *
Chris@0:  * Modules may wish to alter the type URI generated for a resource based on the
Chris@0:  * context of the serializer/normalizer operation.
Chris@0:  *
Chris@0:  * @param string $uri
Chris@0:  *   The URI to alter.
Chris@0:  * @param array $context
Chris@0:  *   The context from the serializer/normalizer operation.
Chris@0:  *
Chris@0:  * @see \Symfony\Component\Serializer\SerializerInterface::serialize()
Chris@0:  * @see \Symfony\Component\Serializer\SerializerInterface::deserialize()
Chris@0:  * @see \Symfony\Component\Serializer\NormalizerInterface::normalize()
Chris@0:  * @see \Symfony\Component\Serializer\DenormalizerInterface::denormalize()
Chris@0:  */
Chris@0: function hook_rest_type_uri_alter(&$uri, $context = []) {
Chris@0:   if ($context['mymodule'] == TRUE) {
Chris@0:     $base = \Drupal::config('serialization.settings')->get('link_domain');
Chris@0:     $uri = str_replace($base, 'http://mymodule.domain', $uri);
Chris@0:   }
Chris@0: }
Chris@0: 
Chris@0: /**
Chris@0:  * Alter the REST relation URI.
Chris@0:  *
Chris@0:  * @deprecated in Drupal 8.3.x and will be removed before Drupal 9.0.0. Use
Chris@0:  *   hook_serialization_relation_uri_alter() instead. This exists solely for BC.
Chris@0:  *
Chris@0:  * @see https://www.drupal.org/node/2830467
Chris@0:  *
Chris@0:  * Modules may wish to alter the relation URI generated for a resource based on
Chris@0:  * the context of the serializer/normalizer operation.
Chris@0:  *
Chris@0:  * @param string $uri
Chris@0:  *   The URI to alter.
Chris@0:  * @param array $context
Chris@0:  *   The context from the serializer/normalizer operation.
Chris@0:  *
Chris@0:  * @see \Symfony\Component\Serializer\SerializerInterface::serialize()
Chris@0:  * @see \Symfony\Component\Serializer\SerializerInterface::deserialize()
Chris@0:  * @see \Symfony\Component\Serializer\NormalizerInterface::normalize()
Chris@0:  * @see \Symfony\Component\Serializer\DenormalizerInterface::denormalize()
Chris@0:  */
Chris@0: function hook_rest_relation_uri_alter(&$uri, $context = []) {
Chris@0:   if ($context['mymodule'] == TRUE) {
Chris@0:     $base = \Drupal::config('serialization.settings')->get('link_domain');
Chris@0:     $uri = str_replace($base, 'http://mymodule.domain', $uri);
Chris@0:   }
Chris@0: }
Chris@0: 
Chris@0: /**
Chris@0:  * @} End of "addtogroup hooks".
Chris@0:  */