weebly/ghost-io-php

SDK library for php to simplify ghost.io API requests.

Ghost IO Unofficial PHP library

, _(*1)

This library is intended to help developer to use the Ghost.io API with their php code., _(*2)

Features

• PSR-4 autoloading compliant structure
• Unit-Testing with PHPUnit
• Easy to use library

Installation

We use packagist to serve this library so is easier to include to any of your projects. Make sure you have composer available in your PATH. To do this you can run the following command in the terminal:, _(*3)

composer require weebly/ghost-io-php

For the most recent dev version:, _(*4)

"require": {
  "weebly/ghost-io-php": "master@dev"
},

Install or update your composer dependencies:, _(*5)

composer install

As a final check you could review your vendor library to see if you have a weeblu/ghost-io-php folder created. Now you're ready to use this on you're code., _(*6)

Usage

use GhostIO\GhostIO;

$ghost = new GhostIO(
    'https://your-blog.ghost.io',   // This is the base url for your blog
    'example@example.com',      // email (username) of the user that will do the API requests
    'password',         // The user password
    'ghost-frontend',       // The client id
    'the-client-secret'     // The client secret
);

$res = $ghost->getAllPosts(); // retrieve all posts from the ghost server

Available Client Methods

The following list shows what methods are available and the route that they represent on the ghost.io API:, _(*7)

$ghost->getAllPosts($fields = [])

| /posts | Get a collection with all the posts of the blog.Some filters apply. | |, _(*8)

$ghost->getPostById($postId)

  | /posts:id          | This will find one specific post by the ID.                          |

|, _(*9)

$ghost->getPostBySlug($slug)

   | /posts:slug           | This will find one specific post by the slug.                        |

|, _(*10)

$ghost->getAllTags($fields = [])

| /tags | Get a collection with all the tags (categories). | |, _(*11)

$ghost->getTagById($tagId)

    | /tags:id           | This will find one specific tag by the ID.                           |

|, _(*12)

$ghost->getTagBySlug($slug)

    | /tags:slug            | This will find one specific tag by the slug.                         |

|, _(*13)

$ghost->getAllUsers($fields = [])

| /users | Get a collection with all the users of the blog. Some filters apply. | |, _(*14)

$ghost->getUserById($userId)

   | /users:id             | This will find one specific user by the ID.                          |

|, _(*15)

$ghost->getUserBySlug($slug)

  | /users:slug        | This will find one specific user by the slug.                        |

|, _(*16)

$ghost->getUserByEmail($email)

| /users/email:email     | This will find one specific user by his email address.               |

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us., _(*17)

Documentation

For more documentation, check the ghost.io API docs here: GhostIO API Docs., _(*18)

Enjoy!, _(*19)