Document geolite2 database installation

Created on 3 March 2023, almost 2 years ago
Updated 4 March 2023, almost 2 years ago

This issue arises from activating the Analytics module. When I did, I got an error message which reads:

Error message
GeoLite2 City Database must be downloaded to the libraries folder. Check out the documentation at https://podcastpublisher.org for more information! (Currently using Geolite2 City Database version None)

So I went over to podcastpublisher.org and I see the CLI installation instructions, and the link back to the profile here on Drupal.org... but when I click "Get Started" which would seem to be the only other option that might lead to documentation, I get a page that appears to be for the "engine" that runs that site, basically telling how to add documentation. I find nothing anywhere that appears to be actual documentation for the module. Nothing talking about GeoLite2 City Database. The profile page here makes no mention of it. I was able to do a Google search and, I believe, found what I was looking for, but I haven't downloaded/tried it yet... but it would be good to mention that the Analytics module requires that library, and where to find it, etc.

πŸ“Œ Task
Status

Active

Version

1.0

Component

Documentation

Created by

πŸ‡ΊπŸ‡ΈUnited States BEGRAFX Laconia, New Hampshire

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

  • Issue created by @BEGRAFX
  • πŸ‡¦πŸ‡ΉAustria arthur_lorenz Vienna

    Yes, you are right, I did not find the time yet to properly document the module. You'll need to have the Geolite 2 city database file in web/libraries/geolite2/GeoLite2-City.mmdb

    You can either download and manually place it there, or add the following repository to your composer.json and run composer require podcast-publisher-analytics/geolite2

            {
                "type": "package",
                "package": {
                    "name": "podcast-publisher-analytics/geolite2",
                    "version": "1.0.0",
                    "type": "drupal-library",
                    "dist": {
                        "url": "https://cdn.jsdelivr.net/npm/geolite2-city@latest/GeoLite2-City.mmdb.gz",
                        "type": "gzip"
                    }
                }
            }
    
Production build 0.71.5 2024