cloudxtreme / states_countries

State/Country manager for Blesta

States & Countries Plugin

---

Description

This is a plugin for the Blesta billing system that allows for the management of states and countries from the admin interface. Blesta comes natively with states that use the subdivision codes from ISO 3166-2 and countries that use 2 and 3-character country codes from ISO 3166-1. However, these states and countries are not used, or are not accurate enough, for some countries. This plugin provides CRUD (Create, Read, Update, Delete) functionality for these countries and states.

---

Requirements

• Version 3.1.0, or greater, of Blesta

How to Install

1. Download the zip containing the plugin's files.
2. Unzip the plugin's files and save them to your Blesta installation under the /plugins/ directory.
3. Login to the Blesta admin interface and navigate to [Settings] -> [Plugins] -> [Available].
4. Click the "Install" button next to the "State/Country Manager" plugin.
5. States and Countries will now be available under [Tools] -> [States&Countries].

Functionality

• Adding/Updating/Deleting Countries
• Adding/Updating/Deleting States

---

Permissions

The use of states and countries from this plugin are subject to Staff Group permissions. Staff Group permissions can be managed by editing a staff group under [Settings] -> [System] -> [Staff] -> [Staff Groups].

Staff Group Permissions

1. States&Countries | This permission grants access to view states and countries under [Tools].
2. States&Countries - Manage Countries | This permission grants access to add, edit, and delete countries.
3. States&Countries - Manage States | This permission grants access to add, edit, and delete states.
   NOTE: States and countries are system-level data, and therefore changes to them will affect the entire system and are not limited to specific companies. Giving a staff group permission to change states or countries on one company gives them the ability to change them for all companies.

---

Screenshots

Viewing all States and Countries In Use

---

Viewing all States for a Specific Country

---

Updating a Country

---

FAQ

How do I view states belonging to a country?
States become visible once you click on the table row for the country. You can also toggle whether to view all states by clicking the "Show All States" button. By default, only those currently in use are shown.

Why do some countries and states have a delete option while others do not?
States and countries that are in use by the system are not deletable. In order for them to become deletable, all uses of them in the system need to be removed. From the listing page, states and countries that are in use are marked by a green checkmark: . You can hover your mouse over this checkmark to see a tooltip about where it is used in the system.

What happens when I update a state or country that is in use within the system?
Updating a state or country that is in use will update all references in the core system to the new value that you set. For example, if a client contact belongs to the country of "United States", denoted by the "US" 2-character country code, and you changed "US" to "ZZ", then the contact will now belong to the "ZZ" country.
The only exception to this is with settings. There is a setting named "country" that stores the default 2-character country code. If you update your default country's 2-character country code, you will need to also update your default country setting for all companies that use it.

Where are states and countries referenced in the system?
As of version 3.5 of Blesta, states and countries are referenced in tax rules, payment accounts, and client contacts. They may also be used in third-party plugins.

---