Quais opções?
Quando um visitante do site solicita uma página, esteja ela já em cache ou não, o SPIP executa um certo número de ações, entre elas, carregar o ficheiro mes_options.php.
Neste ficheiro, é possível:
- definir "constantes" PHP;
- adaptar variáveis de personalização (globais);
- definir funções (ver a propósito o aviso sobre o desempenho).
Ver a lista completa das constantes e variáveis de personalização no glossário.
Criar o ficheiro mes_options.php
Por padrão, o SPIP não fornece este ficheiro.
Estas opções podem ser criadas
- no ficheiro
config/mes_options.phpde um site, - ou num plugin, no ficheiro
prefixoPlugin_options.php
mes_options.php sendo um ficheiro PHP, deve iniciar por <?php (seja bem cuidadoso: não deve existir nenhum caracter ou espaço ou linha em branco antes da tag de abertura <?php).
O SPIP adota as convenções recentes do PHP, portanto é recomendado não usar a tag de fechamento ?>.
<?php
// segurança
if (!defined('_ECRIRE_INC_VERSION')) {
return;
}
// Definir uma constante
// impedir o upload de documentos com mais de 500 KB
define('_DOC_MAX_SIZE', 500);
// Adaptar uma variável de personalização
// forçar a exibição de um menu suspenso a partir de 2010 para
// o campo "Data da primeiro publicação"
$GLOBALS['debut_date_publication'] = '2010';
Uso avançado
Neste ficheiro pessoal pode-se invocar a função spip_initialisation() para definir os diretórios de dados e, por exemplo, dispor assim de vários sites em SPIP usando uma única distribuição (a chamada padrão desta função, mais à frente em inc_version.php, será neutralizada automaticamente).
Ver a propósito Mecanismos de construção das páginas públicas e restritas
Aviso sobre o desempenho
Quando existe, este ficheiro é carregado a cada exibição de página (tanto na área restrita como no espaço público); deve, portanto, ser mantido o mais leve e económico possível.
Ver também
- #CONST: para recuperar o valor de uma constante
- #EVAL: para recuperar o valor de uma variável de personalização
- A seção Variables et Constantes de personnalisation
- Mecanismos de construção das páginas públicas e restritas
Para debugar os erros PHP
No site programmer.spip.net