![\"geotrek](\"/docs/public/assets/geotrek-widget.png\")
\n![\"Documentation\"](\"https://img.shields.io/badge/Documentation-green.svg\"){kind=icon}
\n![\"Geotrek](\"https://img.shields.io/badge/Demo-purple.svg\"){kind=icon}
\n![\"Chat](\"https://img.shields.io/badge/Chat-blue.svg\"){kind=icon}
\n![\"Forum](\"https://img.shields.io/badge/Forum-brightgreen.svg\"){kind=icon}
\n![\"Release\"](\"https://img.shields.io/github/release/GeotrekCE/Geotrek-rando-widget.svg\")
\n
\n![\"Release\"](\"https://github.com/GeotrekCE/Geotrek-rando-widget/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n
\n Widget • \n Features • \n Configuration • \n Documentation • \n
\n\n Support • \n Contribution • \n Contributors • \n License • \n
\n\n\n\n## Widget\n\n**Geotrek-rando-widget** is an intuitive module in the Geotrek suite designed for embedding interactive geographic content on any website. Perfect for tourist offices, natural parks, and organizations promoting a territory, the widget is as simple to embed as a YouTube video.\n\nGeotrek Rando Widget provides a flexible, lightweight solution for integrating [Geotrek-admin](https://github.com/GeotrekCE/Geotrek-admin) data on your website without needing a dedicated platform like [Geotrek-rando](https://github.com/GeotrekCE/Geotrek-rando-v3).\n\n### Test and configure the widget\n\nExplore the widget and its configuration options here: [Widget builder](https://geotrekce.github.io/Geotrek-rando-widget/)\n\n### Examples of Geotrek-widget's integration\n\n- [Walks and Hikes in Sidobre & Valleys, Tarn](https://sidobre-vallees-tourisme.com/type_activite/balades-et-randonnees-sidobre-vallees/)\n- [Hiking in Haut Jura Saint-Claude](https://www.haut-jura-saint-claude.com/pause-aventure/randonnee-haut-jura/)\n- [Cycling Trails in Coeur du Jura](https://www.coeurdujura-tourisme.com/parcours-randonnees-velo/)\n- [Walks and Hikes in Occitanie](https://www.la-toscane-occitane.com/activites/balades-randonnees/)\n\n\n\n## Features\n\nWith a mobile-responsive design, multilingual support, and customizable components, **Geotrek-rando-widget** enables websites to dynamically present treks, activities, services, and events, complete with multilingual support, advanced filtering, and detailed information pages—all easily customizable to suit any site’s needs. Key features include:\n\n- **Web component**: geotrek-rando-widget is a web component that can be easily embedded on any website.\n- **Responsive design**: it adapts to different screen sizes, providing an optimal display on desktop, tablet, and mobile devices.\n- **Geotrek-admin API v2**: retrieves data in real-time via the Geotrek-admin API.\n- **Flexible configuration**: easily customizable and integrable into any website.\n- **Multi-language support**: displays content in multiple languages (e.g. english, spanish) if translations are available in Geotrek-admin.\n- **Advanced filtering and search**: allows users to filter and search objects in a list view with precision.\n- **Detailed list view**: shows published objects (treks, services, tourist events, etc.) with a main photo, name, and key features (difficulty, distance, elevation gain).\n- **Detailed object page**: provides a complete view of an object with all textual details (POI, sensitive areas, recommendations, etc.) configured in Geotrek-admin.\n- **Download options**: users can download GPX/KML route files and a PDF version of the detailed page.\n- **Easy sharing**: users can copy and share the URL of a detailed object page.\n\n## Documentation\n\nFor detailed setup and examples, visit the documentation:\n- [Overview](https://geotrek-rando-widget.readthedocs.io/stable/documentation/introduction/overview.html)\n- [Get started](https://geotrek-rando-widget.readthedocs.io/stable/documentation/introduction/get-started.html)\n\n## Support\n\nHave questions or feedback? Connect with our community:\n- Report issues or suggest features by [submitting a ticket](https://github.com/GeotrekCE/Geotrek-rando-widget/issues).\n- Join discussions on [Matrix](https://matrix.to/#/%23geotrek:matrix.org) or exchange insights in our [Google Group](https://groups.google.com/g/geotrek-fr).\n\n## Contribution\n\nInterested in contributing? Check out our [Contributing Guide](https://geotrek-rando-widget.readthedocs.io/stable/documentation/contribution/development.html). All types of contributions are welcome—even if you’re not a coder!\n\n## Thanks to all contributors ❤\n\n\n![\"Logo](\"https://geotrek.fr/assets/img/logo_makina.svg\"){kind=logo}
\n[](https://datatheca.com/)\n\n","readmeFilename":"readme.md"}