.. include:: ../Includes.txt


.. _developer:

================
For Developers
================

.. _developer-signal-slots:

Events
======
There are a few events provided which mainly happen before postings or applications are being assigned to the view.

You can simply find them by taking a look into ITX\Jobapplications\Event. If you think you need more events than are already provided feel free to
contact us via GitHub or :ref:`E-Mail <start>`.

Custom Filters
==============
If you want to have custom filters you can do that by performing three steps.

#. Configure every filter you want in TypoScript settings, like the default config:
   .. code-block:: php

      filter {
         repositoryConfiguration {
            division {  // Relation name: This is the name you should assign the form element property and the constraint property
               relation = division // Define the relation a la Repository query e.g.: posting.contact.email
               relationType = equals // choose equals, contains or in. This depends on the given relation
            }

            careerLevel {
               relation = careerLevel
               relationType = equals
            }

            employmentType {
               relation = employmentType
               relationType = contains
            }

            location {
               relation = location
               relationType = contains
            }
         }
      }
#. Override the Constraint model, add your custom properties with getters and setters
#. Override the PostingController, by extending the Default one and override the function getFilterOptions()
   This function defines what the filterOptions are. You can write queries to find the options automatically or supply constant ones.
   The data generated by this function gets cached, so perfomance wont be a problem. Also remember to clear all caches after changing something in the filter options.
   .. code-block:: php

      // Function returns an array, matching the configured filters from above
      public function getFilterOptions($categories): array
      {
         return [
            'division' => $this->postingRepository->findAllDivisions($categories),
            'careerLevel' => $this->postingRepository->findAllCareerLevels($categories),
            'employmentType' => $this->postingRepository->findAllEmploymentTypes($categories),
            'location' => $this->locationRepository->findAll($categories)->toArray(),
         ];
      }

#. Last but not least you have to edit the frontend template, so it includes your new filters. You can take the default filters as an example, but basically you have access to the filter options and the user selected filter options in variable called constraint. The controller is also preconfigured to work with both single- and multiselects.