Pular para o conteúdo principal

Configuração

Este documento descreve as configurações do tema e os settings do site utilizados.

Configurações do Tema​

config/theme.ini​

Arquivo: config/theme.ini

Propósito: Define configurações do tema acessíveis via interface administrativa do Omeka S.

Estrutura​

[info]
name = "SGM UFG 2.4.1"
version = "2.4.1"
author = "SGM UFG"
author_link = "https://sgm.ufg.br/"
thumbnail = "theme.png"
omeka_version_constraint = "^4.0.0"

[config]
# Elementos de configuração

Elementos de configuração​

elements.logo.name = "logo"
elements.logo.type = "Omeka\Form\Element\Asset"
elements.logo.options.label = "Logo"

Tipo: Asset (imagem)
Uso: Logo exibido no header e footer
Acesso: $this->themeSettingAssetUrl('logo')

2. Banner​

elements.banner.name = "banner"
elements.banner.type = "Omeka\Form\Element\Asset"
elements.banner.options.label = "Banner"
elements.banner.options.info = "A large image at the top of the page"

Tipo: Asset (imagem)
Uso: Banner grande no topo da página (atualmente não utilizado no layout principal)
Acesso: $this->themeSettingAssetUrl('banner')

3. Banner Height​

elements.banner_height.name = "banner_height"
elements.banner_height.type = "Text"
elements.banner_height.options.label = "Banner height"
elements.banner_height.options.info = "The maximum height the banner should use. Use valid CSS length units (px, em, rem, etc.)"

Tipo: Texto (unidades CSS)
Uso: Altura máxima do banner em desktop
Acesso: $this->themeSetting('banner_height')
Aplicado em: view/common/theme-setting-css.phtml

4. Banner Height Mobile​

elements.banner_height_mobile.name = "banner_height_mobile"
elements.banner_height_mobile.type = "Text"
elements.banner_height_mobile.options.label = "Banner height for mobile devices"
elements.banner_height_mobile.options.info = "The maximum height the banner should use at smaller resolutions. Use valid CSS length units (px, em, rem, etc.)"

Tipo: Texto (unidades CSS)
Uso: Altura máxima do banner em mobile
Acesso: $this->themeSetting('banner_height_mobile')
Aplicado em: view/common/theme-setting-css.phtml (media query)

5. Banner Position​

elements.banner_position.name = "banner_position"
elements.banner_position.type = "Laminas\Form\Element\Select"
elements.banner_position.options.label = "Banner position"
elements.banner_position.options.info = "Where to affix banner image when scaling down using a fixed height."
elements.banner_position.options.value_options.center = "Fix to center"
elements.banner_position.options.value_options.flex_start = "Fix to top"
elements.banner_position.options.value_options.flex_end = "Fix to bottom"

Tipo: Select (dropdown)
Opções:

  • center - Fixar ao centro (padrão)
  • flex_start - Fixar ao topo
  • flex_end - Fixar à base

Uso: Posição do background quando banner tem altura fixa
Acesso: $this->themeSetting('banner_position')
Aplicado em: view/common/theme-setting-css.phtml (propriedade align-items)

elements.footer.name = "footer"
elements.footer.attributes.id = "footer"
elements.footer.type = "Omeka\Form\Element\HtmlTextarea"
elements.footer.options.label = "Footer Content"
elements.footer.options.info = "HTML content to appear in the footer"
elements.footer.attributes.value = "Powered by Omeka S"

Tipo: HTML Textarea
Uso: Conteúdo HTML exibido no rodapé
Acesso: $this->themeSetting('footer')
Aplicado em: view/common/footer.phtml

7. Accent Color​

elements.accent_color.name = "accent_color"
elements.accent_color.type = "Omeka\Form\Element\ColorPicker"
elements.accent_color.options.label = "Main accent color"
elements.accent_color.options.info = "An accent color to be used on links. The default value is #0723BB."
elements.accent_color.attributes.value = "#0723BB"

Tipo: Color Picker
Uso: Cor de destaque para links, botões e elementos destacados
Acesso: $this->themeSetting('accent_color')
Aplicado em:

  • view/common/theme-setting-css.phtml (variável CSS --theme-accent-color)
  • Múltiplos elementos via CSS

Padrão: #0723BB (azul)

8. Media Caption​

elements.media_caption.name = "media_caption"
elements.media_caption.attributes.id = "media_caption"
elements.media_caption.type = "Laminas\Form\Element\Select"
elements.media_caption.options.label = "Media Caption in Viewer"
elements.media_caption.options.description = "Set caption content for when a media is viewed in fullscreen"
elements.media_caption.options.value_options.none = "None"
elements.media_caption.options.value_options.title = "Dublin Core Title"
elements.media_caption.options.value_options.description = "Dublin Core Description"

Tipo: Select (dropdown)
Opções:

  • none - Sem legenda
  • title - Título Dublin Core
  • description - Descrição Dublin Core

Uso: Conteúdo da legenda quando mídia é visualizada em tela cheia
Acesso: $this->themeSetting('media_caption')

Resource Page Regions and Blocks​

Configuração de regiões​

resource_page_regions.items.main = "Main"
resource_page_regions.item_sets.main = "Main"
resource_page_regions.media.main = "Main"

Regiões definidas:

  • items.main - Região principal para itens
  • item_sets.main - Região principal para coleções
  • media.main - Região principal para mídias

Blocos padrão​

resource_page_blocks.items.main[] = "mediaEmbeds"
resource_page_blocks.items.main[] = "values"
resource_page_blocks.items.main[] = "itemSets"
resource_page_blocks.items.main[] = "sitePages"
resource_page_blocks.items.main[] = "mediaList"
resource_page_blocks.items.main[] = "linkedResources"

resource_page_blocks.item_sets.main[] = "values"

resource_page_blocks.media.main[] = "mediaRender"
resource_page_blocks.media.main[] = "values"

Blocos para Itens:

  • mediaEmbeds - Incorporações de mídia
  • values - Valores de propriedades
  • itemSets - Coleções associadas
  • sitePages - Páginas do site associadas
  • mediaList - Lista de mídias
  • linkedResources - Recursos vinculados

Blocos para Coleções:

  • values - Valores de propriedades

Blocos para Mídias:

  • mediaRender - Renderização da mídia
  • values - Valores de propriedades

Site settings utilizados​

1. Search Type​

Chave: search_type
Padrão: sitewide
Valores:

  • sitewide - Busca apenas no site atual
  • cross-site - Busca em todos os sites

Uso: Define URL de ação do formulário de busca
Acesso: $this->siteSetting('search_type', 'sitewide')
Aplicado em:

  • view/common/header.phtml
  • view/common/search-form.phtml
  • view/common/menu-mobile.phtml

2. Filter Locale Values​

Chave: filter_locale_values
Tipo: Boolean
Padrão: false

Uso: Filtrar valores de propriedades por idioma do site
Acesso: (bool) $this->siteSetting('filter_locale_values')
Aplicado em:

  • view/common/resources/meta.phtml
  • view/omeka/site/item/show.phtml
  • view/omeka/site/index/search.phtml
  • view/common/block-layout/browse-preview.phtml

3. Browse Heading Property Term​

Chave: browse_heading_property_term
Tipo: String (termo de propriedade)
Padrão: null

Uso: Propriedade a usar como título em listagens
Acesso: $this->siteSetting('browse_heading_property_term')
Aplicado em:

  • view/common/block-layout/browse-preview.phtml
  • view/omeka/site/item/browse.phtml

Exemplo: dcterms:title, dcterms:subject

4. Browse Body Property Term​

Chave: browse_body_property_term
Tipo: String (termo de propriedade)
Padrão: null

Uso: Propriedade a usar como descrição em listagens
Acesso: $this->siteSetting('browse_body_property_term')
Aplicado em:

  • view/common/block-layout/browse-preview.phtml
  • view/omeka/site/item/browse.phtml

Exemplo: dcterms:description

5. SGMBlocks Search Suggestions​

Chave: sgmblocks_search_suggestions
Tipo: Array
Padrão: []

Uso: Sugestões de busca exibidas abaixo do formulário de busca
Acesso: $this->siteSetting('sgmblocks_search_suggestions', [])
Aplicado em: view/common/search-form.phtml

Estrutura:

[
    ['text' => 'Texto da sugestão', 'url' => '/url-da-busca'],
    // ...
]

Nota: Geralmente configurado pelo módulo SGMBlocks.

6. Pagination Per Page​

Chave: pagination_per_page
Tipo: Integer
Padrão: 25

Uso: Número de itens por página em listagens
Acesso: (int) $this->setting('pagination_per_page', 25)
Aplicado em: view/omeka/site/index/search.phtml

7. Navigation Depth​

Chave: nav_depth (via theme setting)
Tipo: Integer
Padrão: 2

Uso: Profundidade máxima do menu de navegação
Acesso: $this->themeSetting('nav_depth')
Aplicado em: view/common/navigation.phtml

Nota: Se não configurado ou 1, usa 2 como padrão (nível principal + 1 submenu).

Acesso às configurações​

Theme Settings​

// Obter valor
$value = $this->themeSetting('chave');

// Obter valor com padrão
$value = $this->themeSetting('chave', 'padrao');

// Obter URL de asset
$url = $this->themeSettingAssetUrl('chave');

Site Settings​

// Obter valor
$value = $this->siteSetting('chave');

// Obter valor com padrão
$value = $this->siteSetting('chave', 'padrao');

Installation Settings​

// Obter valor
$value = $this->setting('chave');

// Obter valor com padrão
$value = $this->setting('chave', 'padrao');

CSS Dinâmico​

view/common/theme-setting-css.phtml​

Gera CSS inline baseado em configurações do tema:

<style>
    <?php if ($accentColor = $this->themeSetting('accent_color')): ?>
    :root {
        --theme-accent-color: <?php echo $accentColor; ?>;
    }
    /* Aplicado a múltiplos elementos */
    <?php endif; ?>
    
    .banner {
        height: <?php echo ($bannerHeight !== '') ? $bannerHeight : 'auto'; ?>;
        align-items: <?php echo $bannerPosition; ?>;
    }
    
    <?php if ($bannerHeightMobile !== ''): ?>
    @media screen and (max-width:640px) {
        .banner {
            height: <?php echo $bannerHeightMobile; ?>;
        }
    }
    <?php endif; ?>
</style>

Variáveis CSS geradas:

  • --theme-accent-color - Cor de destaque

Estilos aplicados:

  • Altura do banner (desktop e mobile)
  • Alinhamento do banner
  • Cor de destaque em múltiplos elementos

Exemplos de configuração​

  1. Acesse: Admin > Sites > [Seu Site] > Appearance > Theme Settings
  2. Faça upload do logo em "Logo"
  3. Salve

Configurar Cor de Destaque​

  1. Acesse: Admin > Sites > [Seu Site] > Appearance > Theme Settings
  2. Selecione cor em "Main accent color"
  3. Salve

Configurar Busca Cross-Site​

  1. Acesse: Admin > Sites > [Seu Site] > Settings
  2. Em "Search type", selecione "Cross-site"
  3. Salve