wok_gpxviewer

This is a TYPO3 extension, which provides a plugin for integration of GPXViewer from Jürgen Berkemeier.

What does it do?

With including the GPXViewer javascript one can display GPX tracks, routes, waypoints in Google Maps or Openstreetmap. Please refer to the GPXViewer website for more informations about the features of GPXViewer.

This extension/plugin for TYPO3 integrate most of the features of GPXViewer. For some examples please refer to my website. I will also try to do some documentation for the use of the extension there.

What prerequisites are needed?

• TYPO3 10.4.19 and above.
• The bootstrap_package is highly recommended. I only use the extension/plugin with the bootstrap_package and it's ScssPHP compiler. If you don't use it, then you have to include at least Fluid Content Elements (fluid_style_content) into your template (see below).
• For some features you may need exiftool installed on your server.
• Probably you need API keys for use of Google maps or OSM. Find more information about API keys here.
• You don't necessarily need GPX files, you even can create a GPXViewer content element and add your own waypoints or waypoint images with GPS coordinates. You need to know the coordinates from another source. This extension does not provide a way to determine GPS coordinates from a map.
• Commercial use of GPXViewer of Jürgen Berkemeier is restricted. Read more about this and other restrictions here.
• The use of this TYPO3 extension is only restricted insofar as GPXViewer and other provided resources are underlying restrictions.

How to set up?

• Download and install the extension wok_gpxviewer.
• Create a new page in TYPO3 backend or edit an existing one.
• Create an (extension) template for that page or edit an existing (extension) template:
  • In case you're using the bootstrap_package:
    • You have to "Include static (from extensions)" for Bootstrap Package: Full Package (bootstrap_package).
  • In case you're not using the bootstrap_package:
    • You have to "Include static (from extensions)" for Fluid Content Element (fluid_styled_content).
    • You have to change the constant cssFile to EXT:wok_gpxviewer/Resources/Public/CSS/custom.css. You can do that using the Constant Editor or just by adding the line plugin.tx_wokgpxviewer_gpxtracks.gpxviewer.cssFile = EXT:wok_gpxviewer/Resources/Public/CSS/custom.css in the constants part of your template.
• Finally "Include static (from extensions)" for GPXViewer (wok_gpxviewer) to your template.
• Change to Constant Editor and edit the settings for GPXViewer. You will find the categories GPXVIEWER: BASIC and GPXVIEWER: ADVANCED. Please refer to the help texts in constant editor for all configuration options.
• You may need API keys for Google Maps or some OSM maps, see GPXViewer API keys. You can configure them with the constant editor in category GPXVIEWER: BASIC too.
• Now you can create a content element of type plugin and then select GPXViewer tracks display.
• In the tab Plug-in you are able to add GPX files for display in the frontend. There are several tabs with settings to explore. Hopefully most of them are self explaining. If not, don't hesitate to contact me (see below).
• For some examples please refer to my website. You also can download GPX files for test purpose from there.

How can you give your feedback

• I would like to hear from you, how you're using the extension and what can be improved.
  • You can write me a mail, see my website for contact data.
  • You can add issues or pull requests on github.

Todos

• more examples and translation of examples into English
• more documentation
• create TER version