adback/adback-sdk-php-symfony

A bundle to use the AdBack ApiClient

Monday, July 16, 2018
by gignonje
Repository
2 Watchers
0 Stars
4,928 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
22 Versions
19 % Grown

The README.md

Adback/ApiClientBundle

, _(*1)

This bundle will use the library to call the AdBack api., _(*2)

See the AdBack website for more informations., _(*3)

Installation

Launch the composer command :, _(*4)

    composer require adback/adback-sdk-php-symfony

If you are using a version of symfony >= 4, it should automatically activate the bundle., _(*5)

If you are using a version of symfony < 4, you have to add the bundle to your AppKernel.php file :, _(*6)

    new Adback\ApiClientBundle\Adback\ApiClientBundle(),

Configuration

Symfony 4

In your .env file, the following lines should have been added :, _(*7)

    ADBACK_API_CLIENT_ACCESS_TOKEN=adback-access-token

Modify it with the token provided by the AdBack team., _(*8)

Then follow the paragraph linked to the type of cache you have choosen :, _(*9)

Redis

In the config/packages/adback_sdk_php.yaml you should add the following configuration :, _(*10)

    cache_type: redis
    cache_service: redis_service

redis_service is the name of the redis connection you are using to store the data., _(*11)

Doctrine

In the config/packages/adback_sdk_php.yaml you should add the following configuration :, _(*12)

    cache_type: doctrine
    entity_manager: doctrine.orm.entity_manager

doctrine.orm.entity_manager is the name of the doctrine connection you are using to store the data., _(*13)

Do not forget to create the table linked to the AdBack sdk., _(*14)

Custom

If you want to write your own cache driver, you should create a class that implements Adback\ApiClient\Driver\ScriptCacheInterface and name this service adback_api_client.script_cache., _(*15)

In the config/packages/adback_sdk_php.yaml you should add the following configuration :, _(*16)

    cache_type: custom

If the service is missing, an error will be issued by the Symfony DIC when the service is being used., _(*17)

Symfony < 4

In your app/config/config.yml file, you should add the following lines :, _(*18)

    adback_api_client:
        access_token: "your-access-token"

Modify it with the token provided by the AdBack team., _(*19)

Then follow the paragraph linked to the type of cache you have choosen :, _(*20)

Redis

In the app/config/config.yml you should add the following configuration :, _(*21)

    adback_api_client:
        cache_type: redis
        cache_service: redis_service

redis_service is the name of the redis connection you are using to store the data., _(*22)

Doctrine

In the app/config/config.yml you should add the following configuration :, _(*23)

    adback_api_client:
        cache_type: doctrine
        entity_manager: doctrine.orm.entity_manager

doctrine.orm.entity_manager is the name of the doctrine connection you are using to store the data., _(*24)

Do not forget to create the table linked to the AdBack sdk., _(*25)

Custom

If you want to write your own cache driver, you should create a class that implements Adback\ApiClient\Driver\ScriptCacheInterface and name this service adback_api_client.script_cache., _(*26)

In the app/config/config.yml you should add the following configuration :, _(*27)

    adback_api_client:
        cache_type: custom

If the service is missing, an error will be issued by the Symfony DIC when the service is being used, _(*28)

Script Type

There is two possibilities for the script you could get., _(*29)

Small scripts

This configuration will only load the AdBack script from an external url., _(*30)

This usage is good for a quick start., _(*31)

Full scripts

This configuration will load our full script or bootscrap script., _(*32)

This will allow us to deliver a script which is more flexible when the blocking in place are harder., _(*33)

This solution is recommanded for an advanced usage., _(*34)

Usage

Refresh command

In order to have the AdBack script always up-to-date you should launch the command adback:api-client:refresh-tag periodically (at least once a day)., _(*35)

This command will call our api and store the response in the cache type you have chosen, _(*36)

Add the script to your pages

At the bottom of your webpages, you should add the script twig generation function :, _(*37)

    {{ adback_generate_scripts() }}

Full configuration description

    adback_api_client:
        access_token:         ~ # Required, Your personnal access token
        api_url:              'https://adback.co/api' # The base url for the api
        script_url:           script/me # The api url used to get the script
        cache_type:           redis # The cache type you are using
        generator_type:       script # The type of script you are generating
        cache_service:        redis # The service used for the caching
        entity_manager:       doctrine.orm.entity_manager # The entity manager used (only if you use the doctrine cache

        # This key is used if multiple website access the same database
        key_prefix:           ''

The Versions

16/07 2018

dev-master

9999999-dev

A bundle to use the AdBack ApiClient

symfony-bundle adback-sdk-php-symfony

A bundle to use the AdBack ApiClient

adback/adback-sdk-php-symfony

The README.md

Adback/ApiClientBundle

Installation

Configuration

Symfony 4

Redis

Doctrine

Custom

Symfony < 4

Redis

Doctrine

Custom

Script Type

Small scripts

Full scripts

Usage

Refresh command

Add the script to your pages

Full configuration description

The Versions

dev-master

The Requires

The Development Requires

by Nicolas Thal

v2.8.0

The Requires

The Development Requires

by Nicolas Thal

v2.7.0

The Requires

The Development Requires

by Nicolas Thal

v2.6.2

The Requires

The Development Requires

by Nicolas Thal

v2.6.1

The Requires

The Development Requires

by Nicolas Thal

v2.6.0

The Requires

The Development Requires

by Nicolas Thal

v2.5.0

The Requires

The Development Requires

by Nicolas Thal

v2.4.2

The Requires

The Development Requires

by Nicolas Thal

v2.4.1

The Requires

The Development Requires

by Nicolas Thal

v2.3.1

The Requires

The Development Requires

by Nicolas Thal

v2.4.0

The Requires

The Development Requires

by Nicolas Thal

v2.3.0

The Requires

The Development Requires

by Nicolas Thal

v2.2.0

The Requires

The Development Requires

by Nicolas Thal

v2.1.0

The Requires

The Development Requires

by Nicolas Thal

v2.0.0