/com_regions

A taxonomy-based Regions component to sort by Region which seamlessly integrate with com_cck

Primary LanguagePHP

com_regions

Introduction

Several CTA websites, e.g. Web2fordev have the requirement that content can be filtered by region. Therefore, a taxonomy-based Regions component was developed. This component is designed to integrate seamlessly with the Moyo CCK.

The regions component was developed by Moyo Web Architects.

Requirements

  • Joomla 2.5 or 3.X .
  • Koowa 0.9 or 1.0 (as yet, Koowa 2 is not supported)
  • PHP 5.3.10 or better
  • Composer
  • Moyo Components
    • com_articles
    • com_cck
    • com_moyo
    • com_routes
    • com_taxonomy
    • com_translations
    • com_profile

Installation

Composer

Installation is done through composer. In your composer.json file, you should add the following lines to the repositories section:

from this repository;

{
    "name": "moyo/com_regions",
    "type": "vcs",
    "url": "https://github.com/kedweber/com_regions.git"
}

or from the original repository;

{
    "name": "moyo/com_regions",
    "type": "vcs",
    "url": "https://github.com/moyoweb/com_regions.git"
}

The require section should contain the following line:

    "moyo/com_regions": "1.1.*",

Afterwards, one just needs to run the command composer update from the root of your Joomla project. This will effectively create a composer.lock file which will contain the collected dependencies and the hash codes for each latest release (depending on the require section's format) for each particular repo. Should installations problems occur due to a bad ordering of the dependencies, one may need to go into the lock file and manualy change the order of the components. Running composer update again will again cause a reordering of the lock file, beware of this factor when running an update. Thereafter, you can run the command composer install.

If you have not setup an alias to use the command composer, then you will need to replace the word composer in the previous commands with the commands with php composer.phar followed by the desired action (eg. update or install).

jsymlinker

Another option is to run the jsymlink script in the root folder, available via the original Moyo developer, Joachim van de Haterd's repository, under the Moyo Git Tools.

License jsymlinker

The joomlatools/installer plugin is free and open-source software licensed under the GPLv3 license.

Usage

There is only an administrative backend. The administrative backend can be accessed by navigating to 'Components >> Regions'. Regions are saved as CCK taxonomies in the database. Please consult the documentation for taxonomies for more information.