configuration.php

Go to the documentation of this file.

<?php
use Elgg\Exceptions\Exception as ElggException;
use Elgg\Project\Paths;

function elgg_get_site_url() {
    return _elgg_services()->config->wwwroot;
}

function elgg_get_plugins_path() {
    return _elgg_services()->plugins->getPath();
}

function elgg_get_data_path() {
    return _elgg_services()->config->dataroot;
}

function elgg_get_cache_path() {
    $path = _elgg_services()->config->cacheroot ? : elgg_get_data_path() . 'caches/';
    return Paths::sanitize($path);
}

function elgg_get_asset_path() {
    $path = _elgg_services()->config->assetroot ? : elgg_get_cache_path() . 'views_simplecache/';
    return Paths::sanitize($path);
}

function elgg_get_root_path() {
    return Paths::project();
}

function elgg_sanitize_path(string $path, bool $append_slash = true): string {
    return Paths::sanitize($path, $append_slash);
}

function elgg_get_release(): string {
    static $release;
    
    if (!isset($release)) {
        $composerJson = file_get_contents(\Elgg\Project\Paths::elgg() . 'composer.json');
        if ($composerJson === false) {
            throw new ElggException("Unable to read composer.json file!");
        }
        
        $composer = json_decode($composerJson);
        if ($composer === null) {
            throw new ElggException("JSON parse error while reading composer.json!");
        }
        
        // Human-friendly version name
        if (!isset($composer->version)) {
            throw new ElggException("Version field must be set in composer.json!");
        }
        $release = $composer->version;
    }
    
    return $release;
}

function elgg_get_config($name, $default = null) {
    if (!_elgg_services()->config->hasValue($name)) {
        elgg_log("Config value for '$name' is not set'", 'INFO');
        return $default;
    }

    return _elgg_services()->config->$name;
}

function elgg_set_config($name, $value) {
    _elgg_services()->config->$name = $value;
}

function elgg_save_config($name, $value) {
    return _elgg_services()->config->save($name, $value);
}

function elgg_remove_config($name) {
    return _elgg_services()->config->remove($name);
}

function elgg_get_icon_sizes($entity_type = null, $entity_subtype = null, $type = 'icon') {
    return _elgg_services()->iconService->getSizes($entity_type, $entity_subtype, $type);
}

function elgg_comments_are_latest_first(ElggEntity $container = null) {
    $params = [
        'entity' => $container,
    ];
    return (bool) elgg_trigger_plugin_hook('config', 'comments_latest_first', $params, (bool) _elgg_services()->config->comments_latest_first);
}

function elgg_comments_per_page(ElggEntity $container = null) {
    $params = [
        'entity' => $container,
    ];
    return (int) elgg_trigger_plugin_hook('config', 'comments_per_page', $params, _elgg_services()->config->comments_per_page);
}