markocupic/employee-bundle

4.1.8 2024-11-09 21:29 UTC

Requires

• php: ^8.1
• contao/core-bundle: ^5.3
• menatwork/contao-multicolumnwizard-bundle: ^3.5

Requires (Dev)

• contao/easy-coding-standard: ^5.0
• contao/manager-plugin: ^2.3.1
• contao/test-case: ^4.5
• phpunit/phpunit: ^9.3
• symfony/http-client: 5.4.*
• symfony/phpunit-bridge: ^5.4

LGPL-3.0+

• Marko Cupic

README

Employee Bundle

This extension for Contao CMS enables the presentation of employees on a company website. Employees can be entered via the backend module. The extension offers a list module and a reader/detail module for output in the frontend.

Backend

Insert Tags

It is possible to retrieve details or the individual picture of a specific employee via Contao InsertTag in TWIG.

<div>Title: {{ insert_tags('employee::##alias##::##fieldname##') }}</div>

Examples

{# templates/rsce_employee_detail.html.twig #}

<div>Firstname: {{ insert_tag('employee::adam-riese::firstname') }}</div>
<div>Lastname: {{ insert_tag('employee::adam-riese::lastname') }}</div>
<div>Image: {{ insert_tag('employee::adam-riese::image::mode=proportional&width=200')|raw }}</div>
<div>Picture: {{ insert_tag('employee::adam-riese::picture::size=2')|raw }}</div>
<div>Figure: {{ insert_tag('employee::adam-riese::figure::size=2')|raw }}</div>

{# dynamic #}
<div>Firstname:   {{ insert_tag('employee::'~alias~'::firstname') }}</div>
<div>Figure:   {{ insert_tag('employee::'~alias~'::figure::size='~picture_size) }}</div>

{# VCard download link using the alias or ID #}
<div><a href="{{ insert_tag('employee_vcard_download_url::adam-riese') }}" title="vcard">download VCard</a></div>
<div><a href="{{ insert_tag('employee_vcard_download_url::1') }}" title="vcard">download VCard</a></div>

Events for developers

The two events GenerateVCardEvent and PrepareEmployeeDataEvent give you control over the output before the templates are rendered.