Added Gallery images and Partner references examples

Author: Bertrand Dunogier

doc/examples/gallery_images/ChildrenQueryType.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace AppBundle\QueryType;
+
+use eZ\Publish\Core\QueryType\QueryType;
+use eZ\Publish\API\Repository\Values\Content\Query;
+
+class ChildrenQueryType implements QueryType
+{
+    public function getQuery(array $parameters = [])
+    {
+        $options = [];
+
+        $criteria = [
+            new Query\Criterion\Visibility(Query\Criterion\Visibility::VISIBLE),
+        ];
+
+        if (!empty($parameters['parent_location_id'])) {
+            $criteria[] = new Query\Criterion\ParentLocationId($parameters['parent_location_id']);
+        } else {
+            $criteria[] = new Query\Criterion\MatchNone();
+        }
+
+        if (!empty($parameters['included_content_type_identifier'])) {
+            $criteria[] = new Query\Criterion\ContentTypeIdentifier($parameters['included_content_type_identifier']);
+        }
+
+        $options['filter'] = new Query\Criterion\LogicalAnd($criteria);
+
+        if (isset($parameters['limit'])) {
+            $options['limit'] = $parameters['limit'];
+        }
+
+        $options['sortClauses'] = [new Query\SortClause\DatePublished(Query::SORT_DESC)];
+
+        return new Query($options);
+    }
+
+    public static function getName()
+    {
+        return 'AppBundle:Children';
+    }
+
+    public function getSupportedParameters()
+    {
+        return [
+            'parent_location_id',
+            'included_content_type_identifier',
+            'limit',
+            'whatever'
+        ];
+    }
+}

doc/examples/gallery_images/README.md

@@ -0,0 +1,39 @@
+### Gallery images query field
+A field that lists the images of a gallery.
+
+#### Content type configuration
+The following assumes a "gallery" content type with an "images" query field.
+The actual images are sub-items of the gallery.
+
+##### Query type
+AppBundle:Children
+
+##### Returned type
+Image
+
+##### Parameters
+```yaml
+parent_location_id: '@=mainLocation.id'
+included_content_type_identifier: '@=returnedType'
+```
+
+#### Layout customization
+```yaml
+ezpublish:
+    systems:
+        site:
+            content_view:
+                # Customize the layout around all the images
+                content_query_field:
+                    gallery_images:
+                        match:
+                            Identifier\ContentType: gallery
+                            Identifier\FieldDefinition: images
+                        template: "content/view/content_query_field/gallery_images.html.twig"
+                # Customize the layout of each image
+                line:
+                    images:
+                        match:
+                            Identifier\ContentType: image
+                        template: "content/view/line/images.html.twig"
+```

doc/examples/partner_references/README.md

@@ -0,0 +1,43 @@
+### Partners references query field
+A field that lists the references developed by a partner.
+
+#### Content type configuration
+The "reference' content type with has a "partners" relation list field. Each partner involved in the reference is added.
+
+The "partner" content type has a "references" content query field. It lists all references that include that partner.
+
+##### Query type
+AppBundle:RelatedToContent
+
+##### Returned type
+Reference
+
+##### Parameters
+```yaml
+from_field: partners
+sort_by: Name
+content_type: '@=returnedType'
+to_content: '@=content'
+```
+
+#### Layout customization
+```yaml
+ezpublish:
+    systems:
+        site:
+            languages: [eng-GB]
+            content_view:
+                # Customize the layout around all the images
+                content_query_field:
+                    partner_references:
+                        match:
+                            Identifier\ContentType: partner
+                            Identifier\FieldDefinition: references
+                        template: "content/view/content_query_field/partner_references.html.twig"
+                # Customize the layout of each image
+                line:
+                    reference:
+                        match:
+                            Identifier\ContentType: reference
+                        template: "content/view/line/reference.html.twig"
+```

doc/examples/partner_references/RelatedToContentQueryType.php

@@ -0,0 +1,74 @@
+<?php
+/**
+ * @copyright Copyright (C) eZ Systems AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+
+namespace AppBundle\QueryType;
+
+use eZ\Publish\API\Repository\Values\Content\Content;
+use eZ\Publish\API\Repository\Values\Content\Query;
+use eZ\Publish\Core\QueryType\OptionsResolverBasedQueryType;
+use Symfony\Component\OptionsResolver\OptionsResolver;
+
+/**
+ * For a given content, return items that have a relation to it using a specific field identifier.
+ *
+ * Parameters:
+ * - Content to_content: the content item that is the target of the relations
+ * - string from_field: the identifier of the field that has the relation
+ * - string|string[] content_type (optional): a content type or set of content type to filter on
+ *   Default: name
+ *
+ * @todo add sort direction support
+ */
+class RelatedToContentQueryType extends OptionsResolverBasedQueryType
+{
+    /**
+     * @inheritDoc
+     */
+    protected function configureOptions(OptionsResolver $optionsResolver)
+    {
+        $optionsResolver->setDefined(['to_content', 'from_field', 'content_type', 'sort_by']);
+        $optionsResolver->setRequired(['to_content', 'from_field']);
+        $optionsResolver->addAllowedTypes('to_content', Content::class);
+        $optionsResolver->addAllowedTypes('from_field', 'string');
+        $optionsResolver->addAllowedTypes('content_type', 'string');
+
+    }
+
+    /**
+     * @inheritDoc
+     */
+    protected function doGetQuery(array $parameters)
+    {
+        $query = new Query();
+        $query->filter = new Query\Criterion\LogicalAnd([
+            new Query\Criterion\FieldRelation($parameters['from_field'], Query\Criterion\Operator::CONTAINS, [$parameters['to_content']->id])
+        ]);
+        if (isset($parameters['content_type'])) {
+            $query->filter->criteria[] = new Query\Criterion\ContentTypeIdentifier($parameters['content_type']);
+        }
+
+        if (isset($parameters['sort_by'])) {
+            $sortClauseClass = 'Query\SortClause' . $parameters['sort_by'];
+            if (class_exists($sortClauseClass)) {
+                $query->sortClauses[] = new $sortClauseClass(Query::SORT_ASC);
+            }
+        }
+
+        if (empty($query->sortClauses)) {
+            $query->sortClauses[] = new Query\SortClause\ContentName(Query::SORT_ASC);
+        }
+
+        return $query;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public static function getName()
+    {
+        return 'RelatedToContent';
+    }
+}