Configuration file config.inc.php

Database connection

dbType

The built-in Doctrine DBAL driver implementation to use. Default is “pdo_mysql”: A MySQL driver that uses the pdo_mysql PDO extension.

$this->dbType = 'pdo_mysql';

Warning

We cannot guarantee all shop functionality will work if this value is changed.

dbCharset

The charset used when connecting to the database. It is highly related with dbType used.

$this->dbCharset = 'utf8';

Warning

We cannot guarantee all shop functionality will work if this value is changed.

Other database connection variables

$this->dbHost = 'localhost'; // database host name
$this->dbPort  = 3306; // tcp port to which the database is bound
$this->dbName = 'oxid'; // database name
$this->dbUser = 'oxid'; // database user name
$this->dbPwd  = 'oxid'; // database user password

edition

Force shop edition. Even if enterprise or professional packages exists, shop edition can still be forced here.

Possible options: CE|PE|EE or left empty (will be determined automatically - default option).

$this->edition = '';

Debugging

sLogLevel

$this->sLogLevel = 'warning';

You can set the log level to one of the levels defined by PsrLogLogLevel. This level will be used by the default PSR-3 logging implementation of OXID eShop.

Note

Keep in mind that this is the minimum level to be logged and lower levels would not be logged, even if those log levels are used in the code.

The message in the following code example will not be logged to any logging channel, if sLogLevel is set to warning. You would have to set sLogLevel to debug to see something in the error log file.

$logger->debug('Some debug message', [__CLASS__, __FUNCTION__]);

Like this you are able to change the log level temporarily even in productive environments to see more information in your log file.

iDebug

/**
 * Enable debug mode for template development or bug fixing
 * -1 = Log more messages and throw exceptions on errors (not recommended for production)
 * 0 = off
 * 1 = smarty
 * 3 = smarty
 * 4 = smarty + shoptemplate data
 * 5 = Delivery Cost calculation info
 * 6 = SMTP Debug Messages
 * 8 = display smarty template names (requires /tmp cleanup)
 */
$this->iDebug = 0; // default setting 0

The different values do not reflect log levels but rather, which part of the OXID eShop functionality should logged.

Note

This setting is for debugging purposes during development ONLY. It prints out a lot of information directly to the front page and is not suitable for a productive environment.

blDebugTemplateBlocks

Should template blocks be highlighted in frontend?

This is mainly intended for module writers in non productive environment

$this->blDebugTemplateBlocks = false;

blSeoLogging

Configure if requests, coming via stdurl and not redirected to seo url be logged to seologs db table.

$this->blSeoLogging = false;

Note

This is only active in productive mode, as the eShop in non productive more will always log such urls

Timezone configuration

Shop timezone can be set with date_default_timezone_set. Europe/Berlin is default value.

date_default_timezone_set('Europe/Berlin');

sAdminEmail

Force admin email. Offline warnings are sent with high priority to this address.

$this->sAdminEmail = '';

offlineWarningInterval

Defines the time interval in seconds warnings are sent during the shop is offline. 5 minutes is default interval.

$this->offlineWarningInterval = 60 * 5;

blCheckForUpdates

Shop will be checked for version in admin home page only if this option is checked

sAuthOpenIdRandSource

define ‘Auth_OpenID_RAND_SOURCE’ (filename for a source of random bytes)

$this->sAuthOpenIdRandSource  = '/dev/urandom';

blUseTimeCheck

Additionally checks if “oxactivefrom > current date < oxactiveto”

blUseStock

If value is TRUE checks stock state “( oxstock > 0 or ( oxstock <= 0 and ( oxstockflag = 1 or oxstockflag = 4 ) )”

sCustomTheme

Is a global config parameter which activates a template override system for an easier design customization and defines custom theme directory name in ‘views’ folder. The structure of this custom theme has to be the same as main theme. The shop will look up if there is an adapted file in your custom folder; if not it will return to the main folder.

blLogChangesInAdmin

Log all modifications performed in Admin (to oxadmin.log in shop log dir)

$this->blLogChangesInAdmin = false;

blMallSharedBasket

Common cart for subshops use together with option in main shop configurations (Mall tab): “Allow users from other shops”

blSeoMode

Switch off SEO URLs

$this->blSeoMode = false;

blUseCron

Enables or disables the use of cron jobs in config.inc.php

Implemented with OXID eShop version 4.6.0

$this->blUseCron = true;

iCreditRating

Sets the default value of credit rating

Implemented with OXID eShop version 4.7.3

$this->iCreditRating = 1000;

blEnterNetPrice

Prices will be entered without tax

blDemoShop

Enables shop demo mode

$this->blDemoShop= true;

iBasketReservationCleanPerRequest

Works only if basket reservations feature is enabled in admin.

The number specifies how many expired basket reservations are cleaned per one request (to the eShop). Cleaning a reservation basically means returning the reserved stock to the articles.

$this->iBasketReservationCleanPerRequest = 200;

Note

Keeping this number too low may cause article stock being returned too slowly, while too high value may have spiking impact on the performance.

aUserComponentNames

To override FrontendController::$_aUserComponentNames use this array option: array keys are component(class) names and array values defines if component is cacheable (true/false) E.g. array(‘user_class’ => false);

aMultiLangTables

Additional multi language tables list.

blDelSetupDir

Control removal of the Setup directory. It will be removed right after the setup is completed, if configuration is true.

$this->blDelSetupDir = false;

Modules

blDoNotDisableModuleOnError

Disable module auto deactivation

Implemented with OXID eShop versions 5.1.2/4.8.2 and 5.0.11/4.7.11

$this->blDoNotDisableModuleOnError = false;

aModules

Some classes can be overloaded, but only by setting up this information in config.inc.php directly

$this->aModules = array(
    'oxutilsobject' => 'my_oxutilsobject'
);

Uploads and images

aAllowedUploadTypes

File type whitelist for file uploads

$this->aAllowedUploadTypes = array('jpg', 'gif', 'png', 'pdf', 'mp3', 'avi', 'mpg', 'mpeg', 'doc', 'xls', 'ppt');

iPicCount

Change number of item pictures

$this->iPicCount = 12;

sAltImageDir / sSSLAltImageUrl

In case if pictures for articles should be loaded from separate server and are available only through http - it’s enough to include sAltImageDir option in config.inc.php. Then to load picture for article only define the rest http path to the image file. Attention: If this option is set in the configuration file config.inc.php, uploading of product pictures in admin area is not possible! If you are using https, you also have to set the sSSLAltImageUrl option.

$this->sAltImageDir = "[http://[path_to_images_dir_on_server]/";
$this->sSSLAltImageUrl = "[https://[path_to_images_dir_on_server]/";

Import/Export

sCSVSign

Separator for Import/Export

sGiCsvFieldEncloser

Encloser for Import/Export

Robots

aRobots

List of all Search-Engine Robots

$this->aRobots = [
    'googlebot',
    'ultraseek',
    'crawl',
    'spider',
    'fireball',
    'robot',
    'slurp',
    'fast',
    'altavista',
    'teoma',
    'msnbot',
    'bingbot',
    'yandex',
    'gigabot',
    'scrubby'
];

aRobotsExcept

Deactivate Static URL’s for the Robots listed in this array

$this->aRobotsExcept = array();

Session and cookies

blForceSessionStart

Force session start on first page view and for users whose browsers do not accept cookies, append sid parameter to URLs. By default it is turned off.

$this->blForceSessionStart = false;

blSessionUseCookies

Use browser cookies to store session id (no sid parameter in URL)

$this->blSessionUseCookies = true;

aCookieDomains

In case you setup different subdomain for SSL/non-SSL pages cookies may not be shared between them. This setting allows to define the domain that the cookie is available in format: array(_SHOP_ID_ => _DOMAIN_);

$this->aCookieDomains = [
    1 => 'mydomainexample.com'
];

Note

Check setcookie() documentation for more details: http://php.net/manual/de/function.setcookie.php

aCookiePaths

The path on the server in which the cookie will be available on: array(_SHOP_ID_ => _PATH_);

possibility to define path on the server in which the cookie will be available on.

$this->aCookiePaths = [
    1 => '/dev/urandom'
];

Note

Check setcookie() documentation for more details: http://php.net/manual/de/function.setcookie.php

aTrustedIPs

Defines IP addresses, for which session + cookie id match and user agent change checks are off.

aRequireSessionWithParams

This configuration array specifies additional request parameters, which, if received, forces a new session being started.

This is the default array with the request parameters and their values, which forces a new session:

array(
    'cl' => array(
        'register' => true,
        'account'  => true,
    ),
    'fnc' => array(
        'tobasket' => true,
        'login_noredirect' => true,
        'tocomparelist'    => true,
    ),
    '_artperpage' => true,
    'ldtype'      => true,
    'listorderby' => true,
);

If you want to extend this array include in config.inc.php file this option:

$this->aRequireSessionWithParams = array(
    'parameter_name' => array(
        'parameter_value' => true,
    )
);

The keys of the array are the names of parameters and the values of the arrays are the parameter values that lead to the session being started, e.g:

$this->aRequireSessionWithParams = array(
    'fnc' => array(
        'login_noredirect' => true,
    ),
    'new_sid' => true
);

Views

blSkipViewUsage

If you can’t log in to the admin panel, try setting the parameter blSkipViewUsage temproarily to “true”.

Implemented with OXID eShop version 4.7

$this->blSkipViewUsage = true;

blShowUpdateViews

Show “Update Views” button in admin

$this->blShowUpdateViews = true;

Password hashing

passwordHashingAlgorithm

Supported values are the strings PASSWORD_BCRYPT, PASSWORD_ARGON2I and PASSWORD_ARGON2ID. Some of the hashing algorithms may not be available on your system depending on your PHP version.

$this->passwordHashingAlgorithm = 'PASSWORD_BCRYPT';

Algorithm configuration

See http://php.net/manual/en/function.password-hash.php for options and values

Examples:

$this->passwordHashingBcryptCost =  10; // Minimum cost is 4, maximum cost is 31
$this->passwordHashingArgon2MemoryCost =  1024;
$this->passwordHashingArgon2TimeCost =  2;
$this->passwordHashingArgon2Threads =  2;

Enterprise Edition options

Enterprise Edition related config options. These options have no effect on Community/Professional Editions.

iDebugSlowQueryTime

Time limit in ms to be notified about slow queries

$this->iDebugSlowQueryTime = 20;

blUseRightsRoles

Enables Rights and Roles engine. Possible values:

  • 0 - off,
  • 1 - only in admin,
  • 2 - only in shop,
  • 3 - both
$this->blUseRightsRoles = 3;

aMultishopArticleFields

Define oxarticles fields which could be edited individually in subshops.

$this->aMultishopArticleFields = array("OXPRICE", "OXPRICEA", "OXPRICEB", "OXPRICEC", "OXUPDATEPRICE", "OXUPDATEPRICEA", "OXUPDATEPRICEB", "OXUPDATEPRICEC", "OXUPDATEPRICETIME");

Important

Do not forget to add these fields to oxfield2shop table.

Note

The field names are case sensitive here

aSlaveHosts

Database master-slave configuration. Variable contains the list of slave hosts.

$this->aSlaveHosts = array('localhost', '10.2.3.12');