How to update
List of releases
menu

linkGeneral information

Add-on provides filling of the CS-Cart cities catalog with inhabited locality of Ukraine. Add-on includes links with cities of delivery services Nova Poshta, Ukrposhta, Justin.
It is recommended to check Rate areas and Payment methods after add-on installation!

For proper add-on work it is needed Cities add-on to be installed and switched on from Russian CS-Cart edition.

Add-on is developed and works for Ukrainian customers only.

linkCompatibility

Available add-on version CS-Cart/Multi-Vendor compatible versions
v2.2.0 4.11.4 – 4.17.2

Add-on is compatible with the following Themes:

  • YoupiTheme (compatible with correspond CS-Cart version);
  • UniTheme2 (compatible with correspond CS-Cart version);
  • Responsive.

linkSupport

General technical support conditions are available at this link (be sure to review these conditions, all solutions from the AlexBranding development team come with limited technical support).

In order to use our technical support, you need to:

  1. Log in with your order owner account on https://cs-cart.alexbranding.com;
  2. Go to the page My Account → Orders;
  3. Find the corresponding order with the problem add-on in the orders list and pass to its details;
  4. Find the “Support” link next to the corresponding add-on name (near you can find Documentation link also) and click on it;
  5. Fill in the data with the problem, provide access to your CS-Cart installation (path to the administration panel, admin mail, admin password + FTP access) and create a ticket (after you will create the ticket, you will receive an e-mail and a special code to track the ticket in the future);
  6. Wait for the specialist answer in accordance with the regulations of the technical support service and the priority of your ticket.

If you didn't receive an answer within the deadlines, according to the chosen ticket priority, send e-mail info@alexbranding.com with the ticket number, for which you did not receive an answer in time, and the team manager will solve the problem in compliance with regulations.

Technical support by telephone calls and direct e-mails is not provided. Any help comes through tickets and helpdesk. Carefully learn documentation and technical support conditions before creating a request.

linkRestrictions and warnings

We recommend to note general restrictions:

  1. All solutions from AlexBranding developers team require pre-installation of the AB: Addons Manager service addon. It is delivered free of charge and is responsible for such services: installation, upgrades, license verifications. Excluding this service addon usage is not possible;
  2. Addon files may have a closed (encoded) part, in which only a license check is located;
  3. The addon will work only on those domains, that are specified in the user's license. If you try to use the solution on CS-Cart installations, whose domains are not included in the license, the addon will be automatically turned off;
  4. Local installation is not possible, so that the addon works on the additional domain (subdomain), enter this domain (subdomain) in the Domain field, when ordering (or write to info@alexbranding.com) - adding technical domains for the developing or for testing is always free.

linkUsage

linkInstallation

After your order has been processed by our manager, it will be transferred to Completed state, you will receive an email to your mailbox with ordered add-ons license numbers (usually it takes from 15 minutes to 8 hours depending on the day time and week day).

Then follow the steps below, which differs depending on your version of the CS-Cart platform:

If you have CS-Cart 4.16.1 and newer version

If you have CS-Cart 4.13.1 and newer version

If you have CS-Cart 4.12. *

If you have CS-Cart 4.11.5 and an earlier version

You can also install the add-on with a standard installation for CS-Cart. To do this, download the appropriate archive with an add-on version compatible with your version of the CS-Cart platform.
Go to the website cs-cart.alexbranding.com, log in under the account of the order holder and go to the page My Profile → Orders → Relevant Order, go to details and you will see a list of available archives for the ordered add-on. Download the version (archive) you need and make the installation (standard for CS-Cart installation: Add-ons → Downloaded add-ons and in the gearwheel menu select Manual installation).

Service add-on AB: Add-ons Manager must be installed and have Active status.

After add-on installation AB: Cities of Ukraine you should import city base (see the section Data management)

linkData management

Data management screen

To import base of cities and regions of Ukraine, go to the page Administration panel → Add-ons → Manage add-ons and at the add-on name AB: Cities of Ukraine in the gearwheel menu select Data management.

1. Import cities and states base ‒ allows to import base of cities and regions of Ukraine. To prevent duplicates when retrying base of cities and regions, the base will be overwritten.

linkShipping address of the order

Imported base of the cities and regions can be used on the editing page of order with the possibility of AutoComplete. Go to the page Administration panel → Orders → View orders → [order number] and in the gear-wheel menu select Edit order. On the left panel click edit Shipping address. In the field Country select Ukraine, in the field State/province select appropriate region and in the field City begin printing the city name, whereafter you will see AutoComplete list.

Editing page of the order

linkIntegrations

1. Предоставление справочников городов для Justin
Relevant for add-ons:

Модуль Ukrainian cities является обязательным модулем, который предоставляет справочники городов.

2. Предоставление справочников городов для Новой Почты
Relevant for add-ons:

Модуль Ukrainian cities является обязательным модулем, который предоставляет справочники городов.

3. Предоставление справочников городов для Укрпошты
Relevant for add-ons:

Модуль Ukrainian cities является обязательным модулем, который предоставляет справочники городов.

linkHow to update

To have possibility to update an add-on, you must have an active subscription period for add-on license.

AB: Add-ons Manager will notify you about available updates (you will see an indicator of new alerts). The recommended way is to update via the CS-Cart Upgrade center (a regular procedure of the platform). This method will allow lossless configuration of the transition to the new add-on version, that is guaranteed to be compatible with your CS-Cart platform version.

Before updating, always make a full database and your store files backup (we recommend backing up using server or hosting tools).

To make updates procedure:

  1. Go to the Administration panel → Administration → Upgrade center;
  2. Find the appropriate update among the available updates and click the Update button;
  3. Follow all the instructions, that will be shown during the upgrade procedure;
  4. Clear CS-Cart cache and start using new add-on version.

If you have an earlier version of the add-on (without the Upgrade center support)

linkList of releases


Subscribe to our Telegram-channel to get info about new releases.

v2.2.0 from 12 December 2023

New features and improvements:
[+] Added multilingual search of settlements on the checkout page.
[+] Added support and translation of settlements in English.

Functionality changes:
[*] Updated the reference book, dated on 12.08.2023

Attention! After add-on update, you should import a database of cities and districts.

v2.1.0 from 23 February 2023

Attention! To get specifications for names of cloned inhabited localities, you should import data base of cities and regions.

New features and improvements:
[+] Added specification for names of inhabited localities that have been cloned.

Bug fixes:
[!] Names of inhabited localities for Ukrainian languages have been displayed in Russian language on condition that language code in Ukrainian was "ua". Fixed.
[!] On the checkout page name of inhabited locality have not been changed on the selected one after changing a language. Fixed.

v2.0.1 from 02 December 2022

New features and improvements:
[+] Updated identifiers of settlements that were released by the Armed Forces of Ukraine dated September 28, 2022.

v2.0.0 from 28 September 2022

Attention! This add-on version will overwrite actual data base of cities of Ukraine automatically. It needs because of updated internal links of Ukrposhta and Justin services.

For a correct work of "Cities of Ukraine 2.0.0" add-on, please, update also "Ukrposhta" add-on upto version 1.3.5, "Justin" add-on upto version 1.1.2 and higher!

Strongly recommend to make a backup version of the data base before add-on update!

New features and improvements:
[+] Updated database of Ukrainian inhabited localities.
[+] Added longitude and latitude for inhabited localities of Ukraine.

v1.3.1 from 30 September 2021

Bug fixes:
[!] When loading a base of cities on an empty base, regions of Ukraine were not created. Fixed.

v1.3.0 from 26 Jule 2021

New features and improvements:
[+] Added support of "AB: Justin" add-on.

Functionality changes:
[*] Cities database was updated.

v1.2.0 from 13 May 2021

After update, you have to refresh settlements base!

Functionality changes:
[*] Add-on "AB: Nova Poshta". Updated references for more than 500 settlements.

Bug fixes:
[!] Fixed names of 10 cities.

v1.1.0 from 23 December 2020

New features and improvements:
[+] Added compatibility with CS-Cart 4.12.1

Functionality changes:
[*] Add-on "AB: Nova Poshta". Actualized relations of cities to Nova Poshta database.

v1.0.3 from 19 November 2020

Attention!

After update, you have to refresh settlements base!

Functionality changes:
[*] Updated names for 798 cities.

Bug fixes:
[!] In Administration panel of the site, city auto-implementation didn’t work on the editing order page when the storefront was closed. Fixed.
[!] “AB: Nova Poshta” add-on. Warehouses list was not shown for Hurovka village, Kirovohrad region.

v1.0.2 from 27 October 2020

Bug fixes:
[!] Multi-Vendor, “AB: Nova Poshta” add-on. On the page of shipping method setting, error occurred when a vendor chose city. Fixed.
[!] “Maps and Geolocation” add-on. Geolocation identified cities Kiev and Dnepr incorrect. Fixed.
[!] Updated 5 cities.

v1.0.1 from 15 September 2020

Bug fixes:
[!] Updated 367 cities.

v1.0.0 from 15 September 2020

Add-on supplements the base of cities with the list of Ukrainian residential places.