Chill-project/chill-bundles
6
0
Fork 0
mirror of https://gitlab.com/Chill-Projet/chill-bundles.git synced 2025-06-07 18:44:08 +00:00
Code Issues Actions Projects Releases Wiki Activity

fix documentation for timeline

Browse Source
This commit is contained in:
Julien Fastré 2021-05-26 17:58:58 +02:00
parent 2cb9dfc250
commit 75c586fbf8
1 changed files with 22 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
docs/source/development/timelines.rst
View File

@ -97,7 +97,7 @@ The has the following signature :
* *
* @param string $context * @param string $context
* @param mixed[] $args the argument to the context. * @param mixed[] $args the argument to the context.
* @return string[] * @return TimelineSingleQuery
* @throw \LogicException if the context is not supported * @throw \LogicException if the context is not supported
*/ */
public function fetchQuery($context, array $args); public function fetchQuery($context, array $args);
@ -163,18 +163,16 @@ The has the following signature :
The `fetchQuery` function The `fetchQuery` function
^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^
The fetchQuery function help to build the UNION query to gather events. This function should return an associative array MUST have the following key : The fetchQuery function help to build the UNION query to gather events. This function should return an instance of :code:`TimelineSingleQuery`. For you convenience, this object may be build using an associative array with the following keys:
* `id` : the name of the id column * `id` : the name of the id column
* `type`: a string to indicate the type * `type`: a string to indicate the type
* `date`: the name of the datetime column, used to order entities by date * `date`: the name of the datetime column, used to order entities by date
* `FROM` (in capital) : the FROM clause. May contains JOIN instructions * `FROM`: the FROM clause. May contains JOIN instructions
* `WHERE`: the WHERE clause;
* `parameters`: the parameters to pass to the query
Those key are optional: The parameters should be replaced into the query by :code:`?`. They will be replaced into the query using prepared statements.
* `WHERE` (in capital) : the WHERE clause.
Where relevant, the data must be quoted to avoid SQL injection.
`$context` and `$args` are defined by the bundle which will call the timeline rendering. You may use them to build a different query depending on this context. `$context` and `$args` are defined by the bundle which will call the timeline rendering. You may use them to build a different query depending on this context.
@ -186,6 +184,15 @@ For instance, if the context is `'person'`, the args will be this array :
'person' => $person //a \Chill\PersonBundle\Entity\Person entity 'person' => $person //a \Chill\PersonBundle\Entity\Person entity
); );
For the context :code:`center`, the args will be:
.. code-block:: php
array(
'centers' => [ ] // an array of \Chill\MainBundle\Entity\Center entities
);
You should find in the bundle documentation which contexts are arguments the bundle defines. You should find in the bundle documentation which contexts are arguments the bundle defines.
.. note:: .. note::
@ -199,13 +206,12 @@ Example of an implementation :
namespace Chill\ReportBundle\Timeline; namespace Chill\ReportBundle\Timeline;
use Chill\MainBundle\Timeline\TimelineProviderInterface; use Chill\MainBundle\Timeline\TimelineProviderInterface;
use Chill\MainBundle\Timeline\TimelineSingleQuery;
use Doctrine\ORM\EntityManager; use Doctrine\ORM\EntityManager;
/** /**
* Provide report for inclusion in timeline * Provide report for inclusion in timeline
* *
* @author Julien Fastré <julien.fastre@champs-libres.coop>
* @author Champs Libres <info@champs-libres.coop>
*/ */
class TimelineReportProvider implements TimelineProviderInterface class TimelineReportProvider implements TimelineProviderInterface
{ {
@ -227,16 +233,17 @@ Example of an implementation :
$metadata = $this->em->getClassMetadata('ChillReportBundle:Report'); $metadata = $this->em->getClassMetadata('ChillReportBundle:Report');
return array( return TimelineSingleQuery::fromArray([
'id' => $metadata->getColumnName('id'), 'id' => $metadata->getColumnName('id'),
'type' => 'report', 'type' => 'report',
'date' => $metadata->getColumnName('date'), 'date' => $metadata->getColumnName('date'),
'FROM' => $metadata->getTableName(), 'FROM' => $metadata->getTableName(),
'WHERE' => sprintf('%s = %d', 'WHERE' => sprintf('%s = ?',
$metadata $metadata
->getAssociationMapping('person')['joinColumns'][0]['name'], ->getAssociationMapping('person')['joinColumns'][0]['name'])
$args['person']->getId()) )
); 'parameters' => [ $args['person']->getId() ]
]);
} }
//.... //....