pedroborges/meta-tags

PHP 的 HTML 元标签生成器。

v0.0.2 2018-07-07 18:21 UTC

This package is auto-updated.

Last update: 2024-09-22 03:22:29 UTC


README

PHP 的 HTML 元标签生成器。支持开箱即用的 Open GraphTwitter CardsJSON Linked Data

安装

composer require pedroborges/meta-tags

基本用法

创建一个新的 MetaTags 实例,然后您可以开始添加元标签

use PedroBorges\MetaTags\MetaTags;

$tags = new MetaTags;

// <title>My Awesome Site</title>
$tags->title('My Awesome Site');

// <meta name="description" content="My site description">
$tags->meta('description', 'My site description');

// <link rel="canonical" href="https://pedroborg.es">
// <link rel="alternate" hreflang="en" href="https://en.pedroborg.es">
$tags->link('canonical', 'https://pedroborg.es');
$tags->link('alternate', [
'hreflang' => 'en',
'href' => 'https://en.pedroborg.es'
]);

// <meta property="og:title" content="The Title">
// <meta property="og:type" content="website">
// <meta property="og:url" content="https://pedroborg.es">
// <meta property="og:image" content="https://pedroborg.es/cover.jpg">
$tags->og('title', 'The title');
$tags->og('type', 'website');
$tags->og('url', 'https://pedroborg.es');
$tags->og('image', 'https://pedroborg.es/cover.jpg');

// <meta name="twitter:card" content="summary">
// <meta name="twitter:site" content="@pedroborg_es">
$tags->twitter('card', 'summary');
$tags->twitter('site', '@pedroborg_es');

// <script type="application/ld+json">
// {
//     "@context": "http://schema.org",
//     "@type": "Person",
//     "name": "Pedro Borges"
// }
// </script>
$tags->jsonld([
    '@context' => 'http://schema.org',
    '@type': 'Person',
    'name': 'Pedro Borges'
]);

当您准备好输出它们时,在模板的 <head> 元素中使用 render 方法

<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <?php echo $tags->render() ?>

您也可以只渲染一个标签

    <?php echo $tags->render('title') ?>

或指定要渲染的标签

    <?php echo $tags->render(['og', 'twitter', 'json-ld']) ?>

默认情况下,元标签将使用 4 个空格缩进标签,并按以下顺序排列

  1. <title>
  2. <meta>(通用)
  3. <meta property="og:*">(Open Graph)
  4. <meta name="twitter:*">(Twitter Cards)
  5. <link>
  6. <script type="application/ld+json">(JSON-LD)

您可以在实例化 MetaTag 类时更改这些

use PedroBorges\MetaTags\MetaTags;

$tags = new MetaTags("\t", ['meta', 'title', 'link', 'og', 'twitter', 'json-ld']);

变更日志

此项目的所有重大更改都将记录在: https://github.com/pedroborges/meta-tags/blob/master/changelog.md

许可证

元标签是开源软件,采用 MIT 许可证

版权 © 2018 Pedro Borges oi@pedroborg.es