This wrapper enables PHP developers to quickly and easily get up and running with ButterCMS. It is based of off the API documentation.
PHP 5.3.0 and later.
You can install the bindings via Composer. Run the following command:
composer require buttercms/buttercms-php
To use the bindings, use Composer's autoload:
require_once('vendor/autoload.php');
If you do not wish to use Composer, you can download the latest release. Then, to use the bindings, include the src/ButterCMS.php
file.
require_once('/path/to/buttercms-php/src/ButterCMS.php');
use ButterCMS\ButterCMS;
$butterCms = new ButterCMS('<auth_token>');
// Feeds - returns a SimpleXMLElement object
$feed = $butterCms->fetchFeed('rss');
// Posts
$result = $butterCms->fetchPosts(['page' => 1]);
$meta = $result->getMeta(); // Meta information like pagination
print_r($meta);
$posts = $result->getPosts(); // Get posts array off of result
$post = $posts[0]; // Get the first post
echo $post->getTitle(); // Access attributes using getXxxx() format.
echo $post->getSlug();
$author = $post->getAuthor(); // Access nested objects: Author, Tags, Categories like so
echo $author->getFirstName();
echo $author->getLastName();
// Loop through posts
foreach ($posts as $post) {
echo $post->getTitle();
}
// Query for one post
$response = $butterCms->fetchPost('post-slug');
$post = $response->getPost();
echo $post->getTitle();
// Search
$butterCms->searchPosts('query', ['page' => 1]);
// Authors
$butterCms->fetchAuthor('author-slug');
$butterCms->fetchAuthors(['include' => 'recent_posts']);
// Categories
$butterCms->fetchCategory('category-slug');
$butterCms->fetchCategories(['include' => 'recent_posts']);
// Tags
$butterCms->fetchTag('tag-slug');
$butterCms->fetchTags();
// Content Fields - returns your fields turned in to a multidimensional array
$butterCms->fetchContentFields(['headline', 'FAQ']);