ZodiacPress Atlas

Troubleshooting The Atlas Database

You can check the status of your atlas database by going to ZodiacPress > Settings > Misc tab. You will see an Atlas Status box like this:


ZodiacPress Atlas status


  • The “Status” row should say Active.
  • The “Database table primary key” should say okay.
  • The “Database table index” should say okay.

Please note that if the Status says “installing…” or “Inserting cities data into database” or “Creating table keys…” these are not errors. In this case, please wait for the installation to complete.

If the Status has some other error message, or the Atlas Installer failed

If you tried running the atlas installer, but it failed, use the “Try again” button. You will find this new button that says, “Try installing atlas again.”

The button will be above the Atlas Status box, on the ZodiacPress Settings > Misc tab. If you do not see that button, then either refresh the page, or leave the page and come back to it. Then, the button should be there. This button (Try installing atlas again) will only appear if the Atlas Installer has failed.

Once you click the button, you can leave the page again because it will run in the background. Since it failed once before, give it a longer time to run, at least 15 minutes. After 15 minutes, go back to the page (ZodiacPress Settings > Misc tab) to check the status. If the status says that it’s still doing some task, give it more time.

Sometimes, you may have to “try again” 2 or 3 times to get the Atlas completely installed. Remember, this is installing more than 3.4 million cities into your database.

Status is Active, but City field does not work

If the Atlas Status is Active, but when you try to enter a city on the birth report form, no cities appear, it is time to request help. When you request help, please say which browser you used to test your form. For example, some browsers are Chrome, Microsoft Edge, Firefox, Safari, etc.

Rare Case: You Moved The Atlas From a Separate Database to WordPress Database

If you used a separate database for the atlas, but later decide to move the atlas into the WordPress database (the regular way via the plugin settings), the atlas installation will not work until you remove the filter code. The filter code is what you added in step 12 when you originally created the separate database.

Updated on June 5, 2019

We've 5 Responses

  1. August 11th, 2019 at 10:40 am

    I have an issue with the installation of the ZP Atlas.
    I receive the error message:
    unzip failed because:

    Is there any Manuel possibility to install a dump?

  2. August 12th, 2019 at 8:23 am

    Hi, the following error:

    Fatal error: Uncaught Error: Call to undefined function zp_script_localization_data() in /html/wordpress/wp-content/plugins/zp-atlas-1.1/zp-atlas.php:123 Stack trace: #0 /html/wordpress/wp-includes/class-wp-hook.php(286): zpa_register_scripts('') #1 /html/wordpress/wp-includes/class-wp-hook.php(310): WP_Hook->apply_filters(NULL, Array) #2 /html/wordpress/wp-includes/plugin.php(465): WP_Hook->do_action(Array) #3 /html/wordpress/wp-includes/script-loader.php(2537): do_action('wp_enqueue_scri...') #4 /html/wordpress/wp-includes/class-wp-hook.php(286): wp_enqueue_scripts('') #5 /html/wordpress/wp-includes/class-wp-hook.php(310): WP_Hook->apply_filters(NULL, Array) #6 /html/wordpress/wp-includes/plugin.php(465): WP_Hook->do_action(Array) #7 /html/wordpress/wp-includes/general-template.php(2745): do_action('wp_head') #8 /html/wordpress/wp-content/themes/Divi/header.php(27): wp_head() #9 /html/wordpress/wp-includes/template.php(722): require_once('/html/wordpress...') #10 /html/wordpress/wp-includes/template.php(671): load_templ in /html/wordpress/wp-content/plugins/zp-atlas-1.1/zp-atlas.php on line 123
      • August 13th, 2019 at 5:24 am

        Thank you for your reply. I´m using the newest version.

        I checked the WP Health report as described but it dosen´t work. That means also Zodiac press without the atlas dosen´t work.

        • August 25th, 2019 at 2:21 pm

          Which version of ZodiacPress are you using? Have you tried updating to the newest ZodiacPress, because the Atlas plugin only works with ZP 1.8 or higher.


Questions and Comments are Welcome

Your email address will not be published. All comments will be moderated.

Please wrap code in "code" bracket tags like this: