PHPackages                             andreaskastl/calendarize-address - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. andreaskastl/calendarize-address

ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility)

andreaskastl/calendarize-address
================================

Extends EXT:calendarize events with location and organizer records based on EXT:tt\_address records and provides corresponding location and organizer views.

7.1.0(11mo ago)110.5k↑250%2GPL-2.0-or-laterPHPPHP ^8

Since Jan 30Pushed 11mo ago2 watchersCompare

[ Source](https://github.com/andreaskastl/calendarize_address)[ Packagist](https://packagist.org/packages/andreaskastl/calendarize-address)[ RSS](/packages/andreaskastl-calendarize-address/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (14)Used By (0)

Typo3 Extension `calendarize_address`
=====================================

[](#typo3-extension-calendarize_address)

Introduction
------------

[](#introduction)

- Extends **Typo3 Calendar extension `calendarize`** with location and organizer records based on popular **Typo3 Address extension `tt_address`**
- Includes adapted event detail view for calendarize extension
- Provides new location view with address details and related events. Optionally a Google Maps visualisation of the location is possible.
- Provides new organizer view with address details and related events

Administration
--------------

[](#administration)

### Prerequisites

[](#prerequisites)

The following prerequisites must be fulfilled to use `calendarize_address` extension

1. `calendarize` extension is installed, see
2. `tt_address` extension is installed, see [https://extensions.typo3.org/extension/tt\_address/](https://extensions.typo3.org/extension/tt_address/)
3. *optionally*: get an API key from Google, if Google Maps visualisation should be used, see

### Installation

[](#installation)

The extension needs to be installed as any other extension of TYPO3 CMS. Get the extension

1. **Install extension via composer command:** Go to your folder where the root composer.json file is located. Type: `composer req andreaskastl/calendarize-address` to get the latest version that runs on your TYPO3 version.
2. **Get it from the Extension Manager:** Press the *Retrieve/Update* button and search for the extension key `calendarize_address` and import the extension from the repository.
3. **Get it from typo3.org:** You can always get current version from [https://extensions.typo3.org/extension/calendarize\_address/](https://extensions.typo3.org/extension/calendarize_address/) by downloading either the t3x or zip version. Upload the file afterwards in the Extension Manager.

The extension ships some TypoScript code which needs to be included.

1. Switch to the root page of your site.
2. Switch to the **Template module** and select *Info/Modify*.
3. Press the link **Edit the whole template record** and switch to the tab *Includes*.
4. Select **Calendarize - Address Extension** at the field *Include static (from extensions)*.

Users Manual
------------

[](#users-manual)

### Creating Address Records

[](#creating-address-records)

All existing address records can be reused in the events. To create new address records:

1. Switch to the **list view**
    1. Create a new page with type **Sysfolder** or
    2. Select an existing page
2. Click the *“+” icon* and select *Address*.
3. Fill out all information you need and save.

### Creating Event Records including Locations or Organizers

[](#creating-event-records-including-locations-or-organizers)

All existing event records can be extended with locations or organizers based on address records. To create a new event and reference locations or organizers:

1. Switch to the **list view**
    1. Create a new page with type **Sysfolder** or
    2. Select an existing page
2. Click the *“+” icon* and select *"Event"*.
3. To add an address record as **location** to the event, go to the field *Location from Addresses* and select one ore more address records
4. To add an address record as **organizer** to the event, go to the field *Organizer from Addresses* and select one ore more address records
5. Fill out other information you need and save.

### Creating a Plugin Content Element

[](#creating-a-plugin-content-element)

For location view and organizer view two separate pages with separate plugins are required - in addition to other pages for e.g. list and detail view. Recommended page structure and corresponding plugins / views:

```
List           (use normal Calendarize plugin with Calendar->list view)
-- Detail      (use normal Calendarize plugin with Calendar->detail view)
-- Month       (use normal Calendarize plugin with Calendar->month view)
-- Day         (use normal Calendarize plugin with Calendar->day view)
-- ...
-- Location    (use Calendarize Location view plugin (A))
-- Organizer   (use Calendarize Organizer view plugin (B))

```

**(A) Location View:**

1. Switch to the **page view**
    1. Create a new page for the location view or
    2. Select an existing page where you want to insert the location view
2. Create a **new content element** and in the *“new content element wizard”* scroll down to the *Calendarize Elements* section and select *"Calendarize - Location View"*
3. Switch to the **Plugin** tab, select *"Calendarize location view"* in the *"Selected Plugin"* field, configure the sysfolder where event records are stored and save.

**(B) Organizer View:**

1. Switch to the **page view**
    1. Create a new page for the organizer view or
    2. Select an existing page where you want to insert the organizer view
2. Create a **new content element** and in the *“new content element wizard”* scroll down to the *Calendarize Elements* section and select *"Calendarize - Organizer View"*
3. Switch to the **Plugin** tab, configure the sysfolder where event records are stored and save.

**Activation and Template Configuration**To finally activate the links from event detail view to location and organizer view, please configure the page ids:

1. Switch to the root page of your site.
2. Switch to the **Template module** and select *"Constant Editor"*.
3. Select **"Calendarize"** in the field *"Category"*.
4. Fill in the page id of (A) in the field locationPid.
5. Fill in the page id of (B) in the field organizerPid.
6. *Optionally*: add your Google Maps API key to enable maps in location view.
7. Save the template and **go to the frontend** to verify if event detail page, location view and organizer view are working as expected. When you click on a location or organizer entry in the event detail view, the location resp. organizer details are shown.

Configuration
-------------

[](#configuration)

### Routing

[](#routing)

If routing is required for location or organizer records, the following configuration will provide a good start for your configuration.

```
    CalendarizeLocation:
      type: Extbase
      extension: Calendarize
      plugin: Location
      limitToPages:
        - 10