Customer scope

Provide a scope mechanism to associate customers to entities.



  • Copy the module into the <thelia_root>/local/modules/ directory and make sure that the name of the module is CustomerScope.
  • Activate it in your Thelia administration panel


Add it in your main Thelia composer.json file

composer require thelia/customer-scope-module:~0.1


A scope is a kind of association that a customer can have. It is defined by a code, and the class of entity that will be associated. Any model class generated by Propel can be used to create a scope.

Scopes must be associated to a scope group.

Customer can be associated to a specific entity instance of a class that has a scope, creating a customer scope. A customer can be associated with any number of entities in any number of scopes. What this association means is up to your business logic.

For exemple, let's say you manage physical stores what to associate customers to them. You can use scopes for that.

Assuming that you have a Store class representing your stores, you can create:

  • A store scope using the Store class
  • A places scope group to contain the store scope

You can then associate a customer to any instance of the Store class, and then easily check to what stores your customer is associated to in your application.


For the time being, scope and scope groups have to be inserted directly into the database. You could for example do this in a module specific to your site, on activation.


The customer scope handler service allows you to add customers to scopes, and to check the scopes a customer belongs to.

It is registered in the container under the id customerscope.customerscope.handler. See the CustomerScopeHandler class for the available methods.



A loop is also available to access the customer scopes.

Input arguments

Argument Description
customer_id Id or list of customer ids.
scope_id Id or list of scope ids.
entity_id Id or list of entity ids.
entity Entity class.

Output arguments

Variable Description



This module provides a CustomerQuery class that extends the base Thelia query and provides methods to filter cutomers by scope.

It can be used in replacement of the base CustomerQuery.

use CustomerScope\Model\CustomerScope as CustomerScopeCustomerQuery;

$customers = CustomerScopeCustomerQuery::create()
        "ScopeEntity" => "myScope",
        "EntityId" => $myEntity->getId(),

Or mixed in your own query class by using the static methods. These methods take a ModelCriteria query class and will act in it.

They assume that the customer table is already present in the query scope, so your query must for exemple extends CustomerQuery or make a join to the customer table.

use CustomerScope\Model\CustomerScope as CustomerScopeCustomerQuery;

// MyQuery extends CustomerQuery
// or MyQuery has a join to the customer table somewhere
$myQuery = MyQuery::create();

        "ScopeEntity" => "myScope",
        "EntityId" => $myEntity->getId(),

Customer scope

The module provides a scope mechanism to associate customers to entities.

Author :

Say Hi & Get in Touch - +33(0)4 44 05 31 00

Thelia Network English
E-commerce solution

E-commerce software, useful to create and manage online stores, published under a free license. Discover our new version, based on many modern technologies !

Download Thelia

A team of experts at your service.


Over 7000 online stores powered by Thelia


Customize your Thelia.


Thelia editor