egulias/egulias-provinces-bundle

Bundle for provinces

Provinces bundle for Symfony2/Doctrine2

This bundle is intended to allow you to easily have the basic structure of regions-provinces of a given country (or all, I hope)., _(*1)

, _(*2)

Installation and configuration:

Get the bundle

Add to your /deps file :, _(*3)

[EguliasProvincesBundle]
    git=http://github.com/egulias/EguliasProvincesBundle.git
    target=/bundles/Egulias/ProvincesBundle

• Side note: if you want provinces and regions in the database, you will need doctrine-fixtures and DoctrineFixturesBundle, _(*4)

  [doctrine-fixtures]   
      git=http://github.com/doctrine/data-fixtures.git
  
  [DoctrineFixturesBundle]
      git=http://github.com/symfony/DoctrineFixturesBundle.git
      target=/bundles/Symfony/Bundle/DoctrineFixturesBundle 
  

And make a php bin/vendors install., _(*5)

Register the namespace

``` php <?php, <sub>(*6)</sub>

// app/autoload.php $loader->registerNamespaces(array( 'Egulias' => DIR.'/../vendor/bundles', // your other namespaces ));, <sub>(*7)</sub>

  * Installation note for Database fixtures:
    Also add this to registerNamespaces

    ``` 'Doctrine\\Common\\DataFixtures' => __DIR__.'/../vendor/doctrine-fixtures/lib',
        'Doctrine\\Common' => __DIR__.'/../vendor/doctrine-common/lib', 
    ```

### Add EguliasProvincesBundle to your application kernel

``` php
<?php

  // app/AppKernel.php
  public function registerBundles()
  {
    return array(
      // ...
      new Egulias\EguliasProvincesBundle\EguliasProvincesBundle(),
      // ...
      );
  }

• Installation note for Database fixtures: Also add
  new Symfony\Bundle\DoctrineFixturesBundle\DoctrineFixturesBundle(),

Usage

• Without a database Just use the needed localized Entity for regions or provinces (as of this writing, only SpainProvince) and use the provided methods., <sub>(*8)</sub>

• With Database Features have been removed, but will be available soon, <sub>(*9)</sub>

  • First you'll need to do a app/console doctrine:schema:update --force (or --dump-sql first to see the sql to be executed) to generate the db tables.
  • Secondly you'll need to dump data with app/console doctrine:fixtures:load --fixtures=vendor/bundles/Egulias/EguliasProvincesBundle/DataFixtures/ORM/ If you want just to dump specific countries data, just point to the corresponding data fixture (e.g LoadSpanishRegions)