Page History

...

Code Block

<?php 
namespace Apps\Posts\Api\Resource; 
use Apps\Core_MobileApi\Api\Resource\ResourceBase; 
class PostResource extends ResourceBase
{
	public $resource_name = "post";
	public $module_name = "post";
	public $title;
	public $description;
	public $text; 
}

In the sample code above, we created PostResource class extended from ResourceBase class. 2 properties $resource_name and $module_name have to be unique and different from other apps. All other class's properties are corresponding to database fields of Posts object

...

In Service folder, create PostApi class what is extended from AbstractResourceApi class and implements MobileAppSettingInterface interface.

All required methods need to be implemented will appear (???). ThenAt this time, we will implement two functions main methods of PostApi class

Method PostApi::findAll() is to get all posts.
Method Two method PostApi::getAppSetting() is and PostApi::getScreenSetting() are to register settings of the Post app to the Native Mobile App. Minimal code show as below:

...

Code Block

<?php

namespace Apps\Posts\Api\Service; 

use Apps\Core_MobileApi\Adapter\MobileApp\MobileApp;
use Apps\Core_MobileApi\Adapter\MobileApp\MobileAppSettingInterface;
use Apps\Core_MobileApi\Api\AbstractResourceApi;
use Apps\Posts\Api\Resource\PostResource; 

class PostApi extends AbstractResourceApi implements MobileAppSettingInterface
{ 
	public function findAll($params = [])
	{
		$posts = [
			new PostResource([
				'post_id' => 1,
				'title' => "Post's title example",
				'description' => "Post's description example",
				'text' => "Post's description example"
			])
		]; 
		return $this->success($posts);
	} 

	public function getAppSetting($param)
	{
		$app = new MobileApp('post' ,[
			'title'=> 'Posts',
			'home_view'=>'menu',
			'main_resource'=> new PostResource([])
		]); 
		return $app;
	}
	
	public function getScreenSetting($param)
	{
		$screenSetting = new ScreenSetting('post', [
            'name' => 'posts'
        ]);
		$resourceName = PostResource::populate([])->getResourceName();
		$screenSetting->addSetting($resourceName, ScreenSetting::MODULE_HOME);
		$screenSetting->addSetting($resourceName, ScreenSetting::MODULE_LISTING);
		$screenSetting->addSetting($resourceName, ScreenSetting::MODULE_DETAIL);

		return $screenSetting;
	}

/* Keep other methods empty for implementation later */
}

We have finished implementing two primary classes of Posts app. Now we need to register Posts app to the Phpfox system

...

Code Block
<?php namespace Apps\Posts; use Phpfox; Phpfox::getLib('module') ->addServiceNames([ 'mobile.post_api' => Api\Service\PostApi::class, ]);

...

Now, you can clear cache in AdminCP and re-open the Native Mobile App, click on the Posts menu item to see how it works.

Let's review the source structure of Posts app

We put all source code to implement API integration in the Api folder

Page tree

Versions Compared

Old Version 5

New Version Current

Key

Let's review the source structure of Posts app