Funções de configurações pré-definidas

As funções a seguir são utilitários para leitura de valores pré-definidos na tabela settings do sistema. Elas utilizam internamente a função get_setting() para acessar o banco de dados e retornar os valores.

Funções de configurações pré-definidas para uso em Templates

site_title()

Retorna o título do site configurado no painel de controle. Ideal para uso em temas, cabeçalhos e elementos dinâmicos do layout.

Parâmetros:
Nenhum

Valor padrão: Nenhum

Retorno: string

Exemplo de uso:

echo site_title();

dateformat()

Retorna o formato de data definido nas configurações do sistema (ex.: d/m/Y, Y-m-d, etc.)

Parâmetros:
Nenhum

Valor padrão: Se não houver uma configuração específica, o formato padrão d/m/Y é utilizado.

Retorno: string

Exemplo de uso:

// para obter datas de tipo de pulicação, o melhor é usar dateformat() 
//     dentro do loop com o método Seek::dates($column) '_date' ou '_update'
$update = new DateTime( Seek::dates('_update') );
echo $update->format( dateformat() );

// para obter datas de tipo de pulicação fora do loop, use o método:
$pages->dates( $type, $column, $slug = '' );
// $type   = 'post' ou 'page'
// $colunm = '_date' ou '_update'
// $slug   = slug da pagina que quer retornar a data | Padrão: slug da pagina atual

// Categorias: Dentro de um loop, é preciso criar a consulta. Fora do loop use: 
$category->dates();

get_setting_json_value()

Retorna um valor específico de um campo que armazena dados no formato JSON. Essa função é útil para configurações que contêm múltiplos valores, como redes sociais ou informações de contato.

Parâmetros:

• $field string
  O nome do campo principal na tabela settings (ex.: 'social_network').
• $key string
  A chave do valor que se deseja extrair do JSON (ex.: 'behance').
• $default string (opcional)
  O valor a ser retornado caso a chave não seja encontrada. padrão ''

Retorno: string

Exemplo de uso:

// Supondo que o campo 'social_network' contenha o JSON:
// {"twitter": "https://x.com/webship_br"}
echo get_setting_json_value( 'social_network', 'twitter' );

social_network()

Um atalho para a função get_setting_json_value(), ideal para acessar URLs de redes sociais. A URL retornada é verificada para garantir que o valor seja válido.

Parâmetros:

• $key string
  O nome da rede social (ex.: 'linkedin', 'pinterest', 'whatsapp').

Retorno: string

Exemplo de uso:

// Retorna a URL do GitHub ou uma string vazia se inválida ou não encontrada.
echo social_network('github');