Download the PHP package kly/onesdk without Composer

One.co.id PHP SDK

This SDK is created for easier intergration and API usage of ONE APP.

For publisher only

Prerequisite

• PHP Version >=5.3.3

Installation

If you are using composer you could get it with composer require kly/onesdk and you are all set. Load up the autoloader and Call the classes or factory you need.

Usage

To use this SDK, there are several basic steps that should be done :

1. Create and load credentials (client_id and client_secret or separated one use access_token)
2. Instance your content into \One\Model\Article object
3. Attach any necessary details (Photos, Videos, Galleries, Or extra Pages)
4. Instance \One\Publisher Object
5. Send your Article object through submitArticle method on Publisher

These are some examples code to perform those steps :

Load credentials

Refer to loadTestEnv() method.

Instance publisher object

Publish

If you want to publish an article, there are several steps should be done :

1. Instance article object

2. Attach if article contains some attachments

   Article supports multiple kind of attachment such as: photo, page.

3. Publish the article to ONE App REST API by submitting through instanced publisher object.

$this->publisher->submitArticle($article);

Fetch

You can fetch all the articles by calling listArticle() on publisher object.

$this->publisher->listArticle();

Steps to contribute :

1. Fork the original repository to your github repository.

2. Clone from your repository

3. To keep up to date with original repository, run this command

4. Create branch. Remember, the name of branch should express what you're doing.

5. Don't forget to install composer dependencies

6. Modify the .env.example file, to reflect correct credentials.

7. Save the .env.example as .env

8. When you are ready to propose changes to the original repository, it's time to create pull request. To create pull request, run the following commands :

9. Go to your github account, on tab pull request, add your comment. Be detailed, use imperative, emoticon to make it clearer.

10. Watch for feedbacks.

PHP CS Fixer

PHP CS Fixer is intended to fix coding standard. So, Remember! to always run PHP CS Fixer before you create pull request.

Testing

How to Run Tests

Open a command prompt or terminal, navigate to project directory and run command composer run test

> php ./phpunit --bootstrap ./test/bootstrap.php ./test/
PHPUnit 4.8.36 by Sebastian Bergmann and contributors.

..................

Time: 14 seconds, Memory: 10.00MB

OK (18 tests, 98 assertions)

To see what test is running you can use command composer run test:verbose

> php ./phpunit --bootstrap ./test/bootstrap.php ./test/
PHPUnit 4.8.36 by Sebastian Bergmann and contributors.

Starting test 'One\Test\Unit\PublisherTest::testSubmitArticleWithoutAttachment'.
.
Starting test 'One\Test\Unit\PublisherTest::testSubmitArticleWithPhotos'.
.
Starting test 'One\Test\Unit\PublisherTest::testSubmitArticleWithPage'.
.
Starting test 'One\Test\Unit\PublisherTest::testSubmitArticleWithGallery'.
.
Starting test 'One\Test\Unit\PublisherTest::testSubmitArticleWithVideo'.

Time: 12.34 seconds, Memory: 10.00MB

OK (18 tests, 98 assertions)

What to Remember When Writing a Test

1. Make sure to create test case for every core function on the class.
2. Always compare data you expected or created before you make a request with the actual data that you get from a response.
3. Use the correct assertion. Avoid using assertEquals to compare arrays because sometimes you will get array (response from server) values sorted in different order from your expected array. In example:

   
   $array = [
   '0'=>'500',
   '1'=>'A'
   ];

$arrayFromResponse = [ '0'=>'A', '1'=>'500 ];

Rather than sorting `$arrayFromResponse` to make the order equal, we can use `assertTrue` combine with `array_diff`

assertTrue(empty(array_diff($array, $arrayFromResponse)));