WordPress 6.5 A versão adiciona uma funcionalidade de biblioteca de tipos de letra que permite aos utilizadores gerir os tipos de letra diretamente no editor. Esta funcionalidade também fornece um conjunto de APIs que permitem aos programadores controlar, ajustar e desativar o comportamento da biblioteca de tipos de letra.
coleção de tipos de letra
Um conjunto de tipos de letra é uma lista de tipos de letra que o utilizador pode instalar através do editor. Um conjunto de tipos de letra é uma lista de tipos de letra que podem ser instalados pelo utilizador através do editor.WordPress Na versão 6.5, estas famílias de fontes são definidas através de uma entrada fontFamily no formato theme.json. Por predefinição, o WordPress 6.5 permite aos utilizadores selecionar a partir de uma lista de colecções de tipos de letra do Google. Note, no entanto, que a instalação das fontes do Google irá descarregar os ficheiros para o servidor do WordPress, de modo a garantir que o site está em conformidade com o RGPD.
Assim que uma coleção de tipos de letra for registada, será apresentada na IU da biblioteca de tipos de letra do editor. A partir daqui, o utilizador pode instalar e ativar facilmente os tipos de letra pretendidos.
Adicionar conjunto de tipos de letra
É possível utilizar owp_register_font_collection()para adicionar uma nova coleção de tipos de letra. Isto pode ser feito fornecendo a família de fontes e a sua lista de fontes em formato PHP ou JSON no array da coleção de fontes.
Abaixo está um exemplo de adição de uma coleção de tipos de letra ao PHP:
Tenha em atenção.Coleção de tipos de letramatriznomeresponder com cânticosdescriçãoprecisam de suportar a tradução, o que pode ser feito envolvendo a cadeia de caracteres no_x()para o fazer. Normalmente, os nomes das famílias de fontes não precisam de ser traduzidos. Para mais informações e discussão de fundo sobre este tópico, consulte a#60509.
No formato JSON, os camposfamílias_de_fontesPode ser um caminho local ou um ficheiro JSON que aponte para um URL remoto.
Eliminar o conjunto de tipos de letra
Pode desativar a coleção de tipos de letra utilizando a função wp_unregister_font_collection(). Segue-se um exemplo de desativação da coleção de tipos de letra predefinida:
Para mais informações, consulte#57980.
Instalação e ativação de tipos de letra
As definições de tipo de letra baseiam-se naDefinição do tipo de letra no formato theme.json. Quando "instala" tipos de letra no seu site, guarda estas definições numa base de dados para que qualquer tema as possa utilizar.
Assim que os tipos de letra forem "activados", o estilo geral do tema será atualizado para incluir estes tipos de letra. Pode utilizar estes tipos de letra nos estilos globais e nas definições de disposição de blocos individuais.
Quando muda para um novo tema, as fontes instaladas têm de ser reactivadas para que o novo tema possa utilizar os estilos dessas fontes. Se redefinir os estilos globais do tema, todas as fontes instaladas serão desactivadas, mas permanecerão no site e poderão ser reactivadas conforme necessário.
Além disso, também pode utilizar as bibliotecas de tipos de letra para desativar os tipos de letra incluídos no tema, o que melhorará a velocidade de carregamento do seu sítio Web.
$font_families = [
array(
'font_family_settings' => (
array (
'fontFamily' => 'Open Sans, sans-serif',
'slug' => 'open-sans',
'fontFace' => (
array (
'fontFamily' => 'Open Sans',
'fontStyle' => 'normal',
'src' => 'https://fonts.gstatic.com/s/opensans/v40/memSYaGs126MiZpBA-UvWbX2vVnXBbObj2OVZyOOSr4dVJWUgsiH0C4iY1M2xLER.woff2'
),
array (
'fontFamily' => 'Open Sans',
'fontStyle' => 'italic',
'src' => 'https://fonts.gstatic.com/s/opensans/v40/memQYaGs126MiZpBA-UFUIcVXSCEkx2cmqvXlWq8tWZ0Pw86hd0Rk8ZkaVIUwaERZjA.woff2'
),
),
), ), ), ), ), ), ), ), ), )
), ), ), ), ), ), ), ), ), )
'categories' => [ 'sans-serif' ],
),
array(
'font_family_settings' => (
array (
'fontFamily' => 'Monoton, system-ui',
'slug' => 'monoton',
'fontFace' => (
array (
'fontFamily' => 'Monoton',
'fontStyle' => 'normal',
'src' => 'https://fonts.gstatic.com/s/monoton/v19/5h1aiZUrOngCibe4fkPBQ2S7FU8.woff2',
'preview' => 'https://s.w.org/images/fonts/17.7/previews/monoton/monoton-400-normal.svg'
),
),
)
),
'categories' => [ 'display' ],
),
array(
'font_family_settings' => (
array (
'fontFamily' => 'Arial, Helvetica, Tahoma, Geneva, sans-serif',
'slug' => 'arial',
)
),
'categories' => [ 'sans-serif' ],
),
];
$categorias = [
array(
'name' => _x( 'Display', 'Font category name' ),
'slug' => 'Display',
),
array(
'name' => _x( 'Sans Serif', 'Font category name' ),
'slug' => 'sans-serif',
),
].
$config = matriz (
'name' => _x( 'A minha coleção de fontes', 'Nome da coleção de fontes' ),
'description' => _x( 'Uma coleção das minhas fontes favoritas.', 'Descrição da coleção de fontes' ),
'font_families' => $font_families, 'font_families' => _x( 'Uma coleção das minhas fontes favoritas.
).
wp_register_font_collection ( 'my-font-collection', $config );Catálogo de carregamento de tipos de letra personalizados
Note que alguns pormenores (por exemplo, nomes de funções) podem ter sido alterados antes da versão 6.5. Pode verificar o#60751e a questão de Gutenberg#59699. para mais informações.
Por predefinição, os tipos de letra carregados são armazenados na pastawp-content/fontsdiretório. No entanto, pode utilizar o diretóriodirectório_de_fontesOs filtros personalizam esta posição conforme necessário. Para aqueles que não suportam a modificação dowp-conteúdoserá instalado utilizando o diretóriowp-content/uploads/fontscomo um catálogo alternativo.
É possível utilizar owp_get_font_dir()para obter a localização do diretório de carregamento de fontes.
O exemplo a seguir altera o diretório de fontes para o diretório "Uploads" do WordPress (o padrão éwp-content/uploads):
Ao modificar a localização de carregamento, é importante garantir que a localização selecionada existe e que as permissões de leitura/escrita adequadas estão definidas.
Tal como acontece com o diretório wp-content/uploads, o diretório de carregamento de fontes não está sujeito aowp_is_file_mod_allowed/NÃO PERMITIR FICHEIROS_MODSrestrições que permitem o carregamento de tipos de letra.
Se necessitar de mais informações, consulte#59417responder com cânticoseste artigo.
Como desativar a biblioteca de tipos de letra
Por predefinição, pode aceder facilmente à biblioteca de tipos de letra através do editor.
Desativar a interface do utilizador
Pode desativar a interface de personalização das definições do editor utilizando filtros.
Desativar a API REST
fazer uso dedesregistar_post_type()remove o tipo de artigo associado a uma biblioteca de fontes e pode ser implementada através da extensão da API REST.
Ao fazê-lo, a extensão pode desativar a funcionalidade da biblioteca de tipos de letra, mantendo a interface de utilizador utilizada para gerir os tipos de letra do tema atual.
Se necessitar de mais informações, consulte#55275responder com cânticos#57818.
Nova API REST
A funcionalidade Biblioteca de tipos de letra introduz três novos pontos de extremidade da API REST:
- wp/v2/colecções de fontes - Pontos de extremidade que fornecem uma lista de famílias de tipos de letra predefinidas, também conhecidas como "colecções".
- wp/v2/font-families - Fornece os pontos finais de uma família de tipos de letra principal, normalmente contendo um ou mais tipos de letra (ou seja, um único tipo de letra).
- wp/v2/font-families//font-faces - Fornece pontos de extremidade para tipos de letra individuais numa determinada família de tipos de letra.
Para saber mais sobre cada novo ponto final, consulte aAPI RESTManuais e#57616.
