PHPackages madj2k/t3-gadgeto-google - 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. [API Development](/categories/api) 4. / 5. madj2k/t3-gadgeto-google ActiveTypo3-cms-extension[API Development](/categories/api) madj2k/t3-gadgeto-google ======================== Extension with Utilites and ViewHelper for accession Google API and Google Maps v13.4.31-stable(2mo ago)0650GPL-2.0+PHPPHP >=8.3 Since May 6Pushed 2mo ago1 watchersCompare [ Source](https://github.com/skroggel/typo3-gadgeto-google)[ Packagist](https://packagist.org/packages/madj2k/t3-gadgeto-google)[ Docs](https://www.steffenkroggel.de)[ RSS](/packages/madj2k-t3-gadgeto-google/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependencies (4)Versions (56)Used By (0) Gadgeto Google ============== [](#gadgeto-google) **Gadgeto Google** is a powerful TYPO3 extension that provides utilities for integrating the Google Geolocation API and Google Maps into your TYPO3 installation. It allows automatic geolocation of records, map display with filters, consent management, and full customization via Fluid templates. --- πŸš€ Features ---------- [](#-features) - Automatically fetches geolocation data (latitude/longitude) from the Google Geolocation API when a record is saved in the backend. - Displays an interactive Google Map with: - Address-based search functionality - Filterable markers via categories - Marker clustering to handle overlapping locations - Clickable markers with custom detail overlays - Ability to add **custom overlays** to highlight regions (e.g., specific countries) - Fully customizable via Fluid templates - Can be configured to use a single location as center of the map or show all definied locations at once - List of all locations, hierarchically ordered by categories - GDPR-compliant consent overlay for map loading - Backend-ordered list of locations by category - Extendable with your own models and repositories - PageTS and TypoScript configuration for dynamic behavior --- ❗Breaking Changes ----------------- [](#breaking-changes) **IMPORTANT - BREAKING CHANGES v13:** New template-structure. If you need to use the old templates, set the following TypoScript config via constants: ``` plugin.tx_gadgetogoogle { view { # cat=plugin.tx_gadgetogoogle/file; type=string; label=Path to template root (FE) templateRootPath = EXT:gadgeto_google/Resources/Private/v12/Templates/ # cat=plugin.tx_gadgetogoogle/file; type=string; label=Path to template partials (FE) partialRootPath = EXT:gadgeto_google/Resources/Private/v12/Partials/ # cat=plugin.tx_gadgetogoogle/file; type=string; label=Path to template layouts (FE) layoutRootPath = EXT:gadgeto_google/Resources/Private/v12/Layouts/ } } ``` **IMPORTANT - BREAKING CHANGES v12:** Add the following classes to your HTML elements: - `js-gadgetogoogle-map-consent-btn`: Consent button that enables the map - `js-gadgetogoogle-map-filter-btn`: Filter buttons interacting with the map --- πŸ“¦ Installation -------------- [](#-installation) 1. Install the extension using the Extension Manager or Composer. 2. Include the **static TypoScript** or use the provided **page setup** template. 3. The extension requires `sjbr/static-info-tables`. Import its tables through the Extension Manager to enable proper country support. --- πŸ”‘ Google API Configuration -------------------------- [](#-google-api-configuration) You need **two separate Google API keys** to use all features: ### 1. Geolocation API Key [](#1-geolocation-api-key) Used to fetch coordinates based on addresses when saving a record in the backend. - **Required access**: Geolocation API - **Restriction type**: IP address (for backend security) ### 2. Maps JavaScript API Key [](#2-maps-javascript-api-key) Used to render the map in the frontend. - **Required access**: Maps JavaScript API - **Restriction type**: HTTP referrer (frontend usage) ### 3. Google Maps ID [](#3-google-maps-id) For enhanced styling and display behavior. - **Map type**: JavaScript - **Style type**: Raster map More details: - [Get API Key](https://developers.google.com/maps/documentation/javascript/get-api-key?hl=en) - [Get Map ID](https://developers.google.com/maps/documentation/get-map-id?hl=en) --- βš™οΈ Extension Configuration -------------------------- [](#️-extension-configuration) Go to **System β†’ Settings β†’ Extension Configuration** in the TYPO3 backend. Available global configuration options include: ### `apiHookTables` [](#apihooktables) Comma-separated list of database tables that should trigger a call to the Google Geolocation API to populate latitude and longitude. > Ensure these tables have all necessary fields (see `ext_tables.sql`, especially `tx_gadgetogoogle_domain_model_location`). ### `defaultCountry` [](#defaultcountry) Defines a default/fallback country used when resolving address queries via the search bar. This value can be overridden in the plugin's FlexForm configuration. ### `removeFields` [](#removefields) Specifies which fields of the location records should be hidden in the backend. Provide a comma-separated list of field names. ### `pluginsWithHeader` [](#pluginswithheader) Controls which plugins display the "header" field in the backend form. --- πŸ›  TypoScript Configuration -------------------------- [](#-typoscript-configuration) Place the following configuration into your TypoScript template to control frontend behavior: ``` plugin.tx_gadgetogoogle.settings { maxSearchRadius = 10000 maxSearchDisplayRadius = 5000 defaultCountry = DE } ``` These options control: - **maxSearchRadius**: Maximum distance (in meters) for address-based search. - **maxSearchDisplayRadius**: Maximum radius for displaying matching markers. - **defaultCountry**: As above, sets default country code. If you're using a proxy server, you can also configure cURL to respect proxy settings to allow external API requests. --- 🧩 FlexForm Customization via PageTS ----------------------------------- [](#-flexform-customization-via-pagets) To extend the available layout options in your plugin FlexForms: ``` // Important: You have to specifiy the extension-plugin (e.g. gadgetogoogle_map) // AND the tab in the flexform (e.g. view) correctly TCEFORM.tt_content.pi_flexform.gadgetogoogle_map.view.settings\.layout { // add new option "List" addItems.list = List // Override label of existing option "default" altLabels.default = Slot // remove option "big" removeItems = big } TCEFORM.tt_content.pi_flexform.gadgetogoogle_map.list.settings\.paginationStyle { // remove option "More" removeItems = More } TCEFORM.tt_content.pi_flexform.gadgetogoogle_map.list.settings\.listStyle { // remove option "Category" removeItems = Category } ``` --- 🎨 Category Style Customization via PageTS ----------------------------------------- [](#-category-style-customization-via-pagets) To define selectable styles for categories: ``` TCEFORM.sys_category.tx_gadgetogoogle_style { // add new option "Layout.1" addItems.list = Layout-1 // Override label of existing option "default" altLabels.default = Slot // remove option "big" removeItems = big } ``` --- 🧩 Restrict Selectable Categories via PageTS ------------------------------------------- [](#-restrict-selectable-categories-via-pagets) To limit the category selection tree in the backend for locations: ``` TCEFORM.tx_gadgetogoogle_domain_model_location.categories { config { treeConfig { startingPoints = 7 // parent category to start from appearance.nonSelectableLevels = 0,1 // make root and parent-category not selectable } } } ``` --- πŸ”„ Integration Into Your Own Extensions -------------------------------------- [](#-integration-into-your-own-extensions) You can integrate the geolocation functionality into your custom extensions in two ways: ### Option 1: Inheritance (Recommended) [](#option-1-inheritance-recommended) Extend your model from the `Location` class provided by this extension. This gives you all geolocation logic out of the box. πŸ‘‰ [Learn how to extend Extbase models in TYPO3](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ExtensionArchitecture/HowTo/ExtendExtbaseModel/Index.html) ### Option 2: Trait + Interface [](#option-2-trait--interface) Implement `\Gadgeto\GadgetoGoogle\Domain\FilterableInterface` and use `FilterableTrait` in your model class. > ⚠ You are responsible for: > > - Defining required TCA and DB fields (see `TCA/tx_gadgetogoogle_domain_model_location.php`) > - Writing your own repositories --- πŸ“ Trigger Geolocation on Record Save ------------------------------------ [](#-trigger-geolocation-on-record-save) ### Recommended Method [](#recommended-method) Add your table to `apiHookTables` in the extension configuration. This automatically triggers geolocation when saving a record. ### Manual Hook (Alternative) [](#manual-hook-alternative) If you prefer a custom hook, register it in `ext_localconf.php`: ``` $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['myhook'] = \Vendor\Extension\Hooks\TceMainHooks::class; ``` In your hook class, call the Geolocation service: ``` use Gadgeto\GadgetoGoogle\Service\GeolocationService; ``` See the example in `Classes/Hooks/TceMainHooks.php`. --- πŸ‘₯ GDPR Consent Overlay ---------------------- [](#-gdpr-consent-overlay) To comply with GDPR (DSGVO), a consent dialog must be shown before loading Google Maps. This overlay is part of the extension. There is a config-file for klaro-consent-manager included. You can use it with `ext:klarokartie` by adding the following lines to your site-config (yaml): ``` klarokratie: klaro: config: EXT:klarokratie/Resources/Public/Config/KlaroConfigMinimal.js includes: - EXT:gadgeto_google/Resources/Public/Klarokratie/Includes/GoogleMaps.js ``` If you want to use a different consent manager, you can use the following JavaScript-Events depending on a given or revoked consent: ``` document.dispatchEvent(new CustomEvent('gadgetoGoogle:consent:given')); ``` ``` document.dispatchEvent(new CustomEvent('gadgetoGoogle:consent:revoked')); ``` --- πŸ“š Resources ----------- [](#-resources) - [Google Maps JavaScript API Documentation](https://developers.google.com/maps/documentation/javascript) - [Google Geolocation API Overview](https://developers.google.com/maps/documentation/geolocation/overview) - [TYPO3 Coding Guidelines](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/CodingGuidelines/Index.html) ### Health Score 48 β€” FairBetter than 94% of packages Maintenance86 Actively maintained with recent releases Popularity15 Limited adoption so far Community7 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~13 days Total 54 Last Release 69d ago Major Versions v12.4.24-stable β†’ v13.4.0-stable2025-10-19 PHP version history (2 changes)v12.4.0-stablePHP >=7.4 v13.4.0-stablePHP >=8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/ca11ace9490b8fe0b145e7d32464fba5c8eddaa88d700b95d32241a226623e76?d=identicon)[SteffenKroggel](/maintainers/SteffenKroggel) --- Top Contributors [![skroggel](https://avatars.githubusercontent.com/u/8121847?v=4)](https://github.com/skroggel "skroggel (65 commits)") --- Tags geolocationTYPO3 CMSgoogle mapsGoogle Geo ### Embed Badge ![Health badge](/badges/madj2k-t3-gadgeto-google/health.svg) ``` [![Health](https://phpackages.com/badges/madj2k-t3-gadgeto-google/health.svg)](https://phpackages.com/packages/madj2k-t3-gadgeto-google) ``` ### Alternatives [jweiland/events2 Events 2 - Create single and recurring events 2165.2k3](/packages/jweiland-events2)[jweiland/maps2 Create maps with Marker, Area, Routes or Radius based on Google Maps or OpenStreetMap 1493.3k17](/packages/jweiland-maps2)[1001pharmacies/geolocation-bundle Provides an abstraction layer for geocoding services. 116.8k](/packages/1001pharmacies-geolocation-bundle)[friendsoftypo3/interest REST and CLI API for adding, updating, and deleting records in TYPO3. Tracks relations so records can be inserted in any order. Uses remote ID mapping so you don't have to keep track of what UID a record has gotten after import. Data is inserted using backend APIs as if a real human did it, so you can can inspect the record history and undo actions. 122.1k1](/packages/friendsoftypo3-interest) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)