tmcycyit/geo-bridge-bundle

GeoBridgeBundle

## Installation

Step1: Download GeoBridgeBundle using composer

Add GeoBridgeBundle in your composer.json:, _(*1)

{
    "require": {
        ...
        "tmcycyit/geo-bridge-bundle": "dev-master",
    }
}

Now update composer.phar, _(*2)

Composer will install the bundle to your project's vendor/yit directory., _(*3)

Step 2: Enable the bundle

Enable the bundle in the kernel:, _(*4)

``` php <?php // app/AppKernel.php, <sub>(*5)</sub>

public function registerBundles() { $bundles = array( // ... new Yit\GeoBridgeBundle\YitGeoBridgeBundle(), ); }, <sub>(*6)</sub>

### If you will use geo_address form field in your project

#### Step 3: Add the following configuration in app/config/config.yml

``` yaml
# app/config/config.yml
twig:
    /...
    form:
            resources:
                - 'YitGeoBridgeBundle:Geo:address.html.twig'

Step 4: Import GeoBridgeBundle routing files

``` yaml, <sub>(*7)</sub>

app/config/routing.yml

yit_geo_bridge: resource: "@YitGeoBridgeBundle/Resources/config/routing.yml" prefix: /, <sub>(*8)</sub>

And then add YitAutocomplete Angularjs module from Bower

Then you can add a new form field`

``` php
$this->createFormBuilder()
             ...
             ->add('address', 'geo_address', array('attr' => array('data_id' => 1)))
             ...

data_id attribute must be unique for each geo_address field. you can also add other attributes to the form field., <sub>(*9)</sub>

``` php $this->createFormBuilder() ... $transformer = $this->container->get('yit_geo_address_trasnformer');, <sub>(*10)</sub>

         ->add(
         $builder->create('address', 'geo_address', array(
            'attr' => array(
                'data_id'       => 1,                   //must be unique for each such field
                'placeholder'   => 'text for input',    //placeholder text
                'allow_new'     => true,                //set true to show new button when address not found
                'button_name'   => 'buttonName',        //text to show on new button
                'button_class'  => 'buttonClass',       //new button class
                'input_class'   => 'inputClass'         //input class
            )))
            ->addModelTransformer($transformer))        //call address Data transformer
         ...

        // in controller call YourFormType
         $form = $this->createForm(new YourFormType($this->container));

Then you can add a address form field in Sonata Admin`

``` php
namespace Project\MyBundle\Admin;

    protected function configureFormFields(FormMapper $formMapper){

            $container = $this->configurationPool->getContainer();
            $transformer = $container->get('yit_geo_address_trasnformer');

            $formMapper
                ->add(
                    $formMapper->create('address', 'geo_address',  array(
                        'attr' => array(
                            'data_id'       => 1,
                            'placeholder'   => 'text for input',
                            'allow_new'     => true,
                            'button_name'   => 'buttonName',
                            'button_class'  => 'buttonClass',
                            'input_class'   => 'inputClass'
                        )))
                        ->addModelTransformer($transformer))
    }

    public function getFormTheme(){

            return array_merge(
                parent::getFormTheme(),
                array('YitGeoBridgeBundle:Admin:geo_admin.html.twig' )
            );
    }

In Sonata Admin template add js, <sub>(*11)</sub>

``` twig, <sub>(*12)</sub>

<script src="{{ asset('app/bower_components/YitAutocomplete/yitAutocomplete.js') }}"></script>
<script src="{{ asset('bundles/yitgeobridge/javascript/geo.js') }}" type="text/javascript"></script>
<script src="{{ asset('bundles/yitgeobridge/javascript/yiInput.js') }}" type="text/javascript"></script>
<script src="{{ asset('bundles/yitgeobridge/javascript/GeoAutocomplete.js') }}" type="text/javascript"></script>

#### Step5: Configured GeoBridgeBundle synchronization using run command after composer install or update

Add RunManageGeoStoredProcedureCommand in your composer.json:

```js
{
 "scripts": {
        "post-install-cmd": [
            "Yit\\GeoBridgeBundle\\Command\\ManageGeoStoredProcedureCommand::manageGeoStoredProcedure"
        ],
        "post-update-cmd": [
            "Yit\\GeoBridgeBundle\\Command\\ManageGeoStoredProcedureCommand::manageGeoStoredProcedure"
        ]
    },
}

Now the bundle is configured and ready to use, if you need to use in entity address, street or district which will a relation with GeoBundle addresses, streets and districts, then you will implements the AddressableInterface, StreetableInterface, MultiAddressableInterface, DistrictableInterface and other interfaces accordingly in your entites. And than when you will load your entity from db, GeoBridgeBundle will automatically call interface functions with corresponding arguments, to set all necessary information., <sub>(*13)</sub>

The interface implementations here`

``` php, <sub>(*14)</sub>

namespace Yit\GeoBridgeBundle\Model;, <sub>(*15)</sub>

//This interface is used when entity has an district_id field interface DistrictableInterface { //This function is used to get district id, the fields of which must be injected public function getDistrictId();, <sub>(*16)</sub>

//This function is used to inject district title
public function setDistrictTitle($title);

}, <sub>(*17)</sub>

namespace Yit\GeoBridgeBundle\Model;, <sub>(*18)</sub>

//This interface is used when entity has street_id field interface StreetableInterface { //This function is used to get street id, the fields of which must be injected public function getStreetId();, <sub>(*19)</sub>

//This function is used to inject street arm_name
public function setStreetArmName($armName);

//This function is used to inject street eng_name
public function setStreetEngName($engName);

}, <sub>(*20)</sub>

namespace Yit\GeoBridgeBundle\Model;, <sub>(*21)</sub>

//This interface is used when entity has an address_id and district_id //fields to set district id based on address id interface AddressDistrictableInterface { //This function is used to get address id public function getAddressId();, <sub>(*22)</sub>

//This function is used to inject district id
public function setDistrictId($id);

//This function is used to get district id
public function getDistrictId();

}, <sub>(*23)</sub>

namespace Yit\GeoBridgeBundle\Model;, <sub>(*24)</sub>

/** * This interface is used when entity has an address_id and district_id * fields to set district id based on address id * district id is set from geo project, and if it is empty persist it, if does not match only set district id without persist */ interface AddressDistrictAwareInterface extends AddressDistrictableInterface {, <sub>(*25)</sub>

}, <sub>(*26)</sub>

namespace Yit\GeoBridgeBundle\Model;, <sub>(*27)</sub>

/** * This interface is used when entity has an address_id and street_id * fields to set street id based on address id * street id is set from geo project and persist it is empty */ interface AddressStreetableInterface { //This function is used to get address id public function getAddressId();, <sub>(*28)</sub>

//This function is used to inject street id
public function setStreetId($id);

//This function is used to get street id
public function getStreetId();

//This function is used to get streetId field name
public function getStreetFieldName();

}, <sub>(*29)</sub>

namespace Yit\GeoBridgeBundle\Model;, <sub>(*30)</sub>

/** * This interface is used when entity has an address_id and street_id * fields to set street id based on address id * street id is set from geo project and persist it is empty, if does not match only set street id without persist */ interface AddressStreetAwareInterface extends AddressStreetableInterface {, <sub>(*31)</sub>

}, <sub>(*32)</sub>

### You can also use 'yit_geo' service to use some functions, there are here`

``` php
//This function return address object from main Geo project by given id
//If there are not any address with such id return null
public function getAddressById($id)

//This function return address object by given id and create it in yit_geo_address table
//If there are not any address with such id return Exception('Address not found!')
public function getAddressObjectById($id)

//This function is used get address synonym ids
public function getSynonymIds($addressId)

//This function is used to get $limit addresses by $search string
//If there are not any address with such content return null
public function searchAddress($search, $limit = 0)

//This function is used to get $limit streets or addresses by $search string
//If there are not any address with such content return null
public function searchFlexibleAddress($search, $limit = 0)

//This function is used to create new address in Geo Project with $addressString title
//when access return id of created Address else return null
public function putAddress($addressString)

//This function is used to get addresses by given id's array
public function getAddresses(array $ids)

//This function is used to create new address in Geo Project with $street, $streetType, $district & $hNumber title
//when access return id of created Address else return null
public function putNewAddress($street, $streetType, $district, $hNumber)

//This function is used to get addresses by $street, $type and $hNumber string
//If there are not any address with such content return null
public function findAddress($street, $type, $hNumber)

//This function return district object by given id
//If there are not any district with such id return null
public function getDistrictById($id)

//This function is used to get districts
//If there are not any district return null
public function getDistricts()

//This function is used to get districts in array 'id' => 'title'
//If there are not any district return empty array
public function getDistrictList()

//This function is used to get all streets by district id
//If there are not any street return null
public function getStreetsByDistrict($districtID)

//This function is used to get district by $search string
//If there are not any district with such content return null
public function searchDistrict($search)

//This function is used get street by given id
//If there are not any street by given id return null
public function getStreetById($id)

//This function is used get street by given address id
//If there are not any address by given id return null
public function getStreetByAddressId($id)

//This function is used to get $limit streets by $search string
//If there are not any street with such content return null
public function searchStreet($search, $limit = 0)

//This function is used to get $limit streets by $search string
//If there are not any street with such content return null
public function searchStreetFlexible($search, $limit = 0)

//This function is used to get $limit streets by $search string and district id
//If there are not any street with such content return null
public function getSearchStreetsByDistrict($search, $district, $limit = 0)

The bundle use apc_cache and by default save addresses in the cache during 24 hours, you can change the time of experience by add the fallowing in your config.yml, <sub>(*33)</sub>

yit_geo_bridge:
    experience: experience_time_in_seconds

You can also add project name in the config to save it in the geo project, this done by add the following in the config.yml, <sub>(*34)</sub>

yit_geo_bridge:
    project_name: your_project_name

You can also add Geo main project domain in the config. If empty this config default http://geo.yerevan.am/, <sub>(*35)</sub>

yit_geo_bridge:
    project_domain: your_project_domain_route