ace-store

Get store info from ACE's store locator API. Supports some neat things., _(*1)

usage

Install using composer:, _(*2)

composer require footsteps-marketing/ace-store

Then use it in your project, _(*3)

require __DIR__ . '/vendor/autoload.php';

$storeNumber = 1234;
$store = new FootstepsMarketing\Ace\Store($storeNumber);
echo $store->getLocationName();

requirements

PHP >=5.6

caching

Caching of Ace store responses can be accomplished in two ways:, _(*4)

define('FSM_ACE_CACHE_FOLDER', '/path/to/cache');
$store = new FootstepsMarketing\Ace\Store(1234);

// or

$store = new FootstepsMarketing\Ace\Store(1234, '/path/to/cache');

Cache lifetime defaults to one week -- it can be modified by setting the constant FSM_ACE_CACHE_LIFETIME, _(*5)

define('FSM_ACE_CACHE_LIFETIME', 1 * 24 * 60 * 60); // Desired lifetime in seconds
define('FSM_ACE_CACHE_FOLDER', '/path/to/cache');
$store = new FootstepsMarketing\Ace\Store(1234);

The Ace store response will be stored in the Ace cache folder as <storenumber>.json, _(*6)

configuration

Configuration can be stored in YAML format at the location set using the constant FSM_ACE_CONFIG_PATH, _(*7)

config.yaml

map:
  exclusive: true               # Return only values with valid mappings?
  departments:                  # 'Original Value': 'New Value'
    'Automotive': 'Auto'
    'Clothing': 'Apparel'
    'Gas Stoves': 'Stoves'
  services:
    'Blade Sharpening': 'Knife Sharpening'
    'Chain Saw Sharpening': 'Chainsaw Sharpening'
    'Gift Card': 'Gift Cards'
    'Special Order 65,000+ items': 'Special Order Services'
  brands:
    'Webber Grills': 'Weber Grills'

PHP

define('FSM_ACE_CONFIG_PATH', '/path/to/config.yaml');
$store = new FootstepsMarketing\Ace\Store(1234);

$brands = $store->getServices(); // This will return values based on the mapping above