monkcms/meta

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

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

Requires

• php: >=5.4.0

Requires (Dev)

• phpdocumentor/phpdocumentor: ~2.9.0
• phploc/phploc: ~3.0.1 || ~4.0.0
• phpmd/phpmd: ~2.5.0 || ~2.9.0 || ~2.10.0 || ~2.15.0
• phpunit/phpunit: ~5.7.5
• sebastian/phpcpd: ~2.0.4 || ~3.0.0
• sensiolabs/security-checker: ~4.0.0 || ~5.0.0
• squizlabs/php_codesniffer: ~2.7.1 || ~3.6.0 || ~3.9.0

MIT

• Monk Development, Inc.
• Skyler Katz

• cms
• monk
• monkdev
• monkcms
• ekklesia
• ekklesia360

README

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 [e-mail]. All security vulnerabilities will be promptly addressed.

License

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