monkcms/meta

A collection of classes to generate module meta information for the MonkCMS API

v0.3.1 2024-02-20 18:48 UTC

This package is auto-updated.

Last update: 2024-10-20 18:00:06 UTC


README

Latest Stable Version Codecov StyleCI

A collection of classes to generate module meta information for the MonkCMS API

Overview

Install

  • Download the site you are working on to your local environment
  • If composer is not installed on your machine globall install it by following the directions here Composer - https://getcomposer.org/download
  • In your terminal go to the directoy where the site was downloaded
  • If there is not a composer.json file in the directory follow the indented steps below. If the file exists, head to the next step
    • Run composer init and select the defaults for all of the main questions. You can select N for defining dependencies and dev dependencies
  • After a composer.json file exists, run the following in the terminal composer require monkcms/meta
  • You will then upload the newly created vendor directory as well as the composer.json and composer.lock files.
  • Follow the How to use section below to implement it on the templates of your choosing.

How to use

Within a template you would initialize the class for the module you are working with. In this example we will assume the pages module.

//Load these in a config.php file
require_once($_SERVER['DOCUMENT_ROOT'] . '/monkcms.php');
require_once($_SERVER['DOCUMENT_ROOT'] . '/vendor/autoload.php');
$currentUrl = 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];

//This would go in the page template after config.php is included
$meta = new \Meta\Module\PageMeta(
    $_GET['nav'],
    getSiteName(),
    'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']
);

Then, in head.php (or anywhere you wish) you can do the following

<title><?= $meta->title() ?></title>
<?= $meta->createMetaTag('description', $meta->description()) ?>
<?= $meta->createMetaTag('keywords', $meta->keywords()) ?>
<?= $meta->socialTags() ?>

The following would be generated

<title>Example Page Title | Test Site Name</title>
<meta name="description" content="Example Page Description" >
<meta name="keywords" content="Example, Page, Keywords" >
<meta property="og:site_name" content="Test Site Name" >
<meta property="og:type" content="article" >
<meta property="og:title" content="Example Page Title | Test Site Name" >
<meta property="og:url" content="http://example.com" >
<meta property="og:image" content="http://www.placecage.com/1200/630" >
<meta property="og:image:width" content="1200" >
<meta property="og:image:height" content="630" >
<meta name="twitter:card" content="summary_large_image" >

Included modules

  • Pages
  • Sermons
  • Articles
  • Blogs
  • Events

Further documentation can be found by looking at the tests.

Contributing

Thank you for considering contributing to the the MonkCMS Meta Package! Please open an issue or a PR with your request! For any new functionality, be sure to write a test.

Security Vulnerabilities

If you discover a security vulnerability within this package, please send an e-mail to Skyler Katz at skylerkatz@hey.com. All security vulnerabilities will be promptly addressed.

License

This package is open-sourced software licensed under the MIT license.