Portal v2

Webservice REST

Handler: include/Webservices/CustomerPortal.php

Headers:
• Authorization: Basic base64_encode("username:accesskey")
• Portal-Session-Id: parameter is optional and is returned by the "portal.login". Use in subsequent calls to optimize portal performance.
• Content-Type: application/json

Register a new REST webservice

This script must be run inCreate a new file withinand vtenextexecute it (e.g. plugins/script/script.php).

SDK::setClass('CustomerPortalRestApi', 'CustomerPortalRestApi2', 'modules/SDK/src/CustomerPortalRestApi2.php');

$parameters = ['param1' => 'string', 'param2' => 'encoded'];
$perm = 'read'; // read, write, readwrite
SDK::setRestOperation('portal.foo', 'include/Webservices/CustomerPortal.modules/SDK/src/CustomerPortalRestApi2.php', 'CustomerPortalRestApi.CustomerPortalRestApi2.foo', $parameters, $perm);

Create a new file that contains the CustomerPortalRestApi2 class (e.g. modules/SDK/src/CustomerPortalRestApi2.php).

<?php

require_once('include/Webservices/CustomerPortal.php');

class CustomerPortalRestApi2 extends CustomerPortalRestApi {

	public function foo($param1, $param2) {
		$data = [1, 2, 3, 4, 5];
		return $data;
	}

}

Extend an existing REST webservice

This script must be run inCreate a new file withinand vtenextexecute it (e.g. "plugins/script/script.php")php).

SDK::setClass('CustomerPortalRestApi', 'CustomerPortalRestApi2', 'modules/SDK/src/CustomerPortalRestApi2.php');

Create a new file tothat placecontains insidethe vtenextCustomerPortalRestApi2 class​ (e.g. "modules/SDK/src/CustomerPortalRestApi2.php")php).

<?php

require_once('include/Webservices/CustomerPortal.php');

class CustomerPortalRestApi2 extends CustomerPortalRestApi {

	public function get_list($module, $language, $folderid = 0) {
		//$ret return= parent::get_list($module, $language, $folderid);
		// your custom code here ...
		return $ret;
	}

}

Structure of main folders/files

The portal folder is located at: VTE_ROOT/portal/v2

The main folders/files of the new portal are:

Request lifecycle

Portal configuration

The portal configuration file is located in "config/portal.config.php".

To overwrite the parameters the "config/sdk.config.php" file must be used otherwise, in case of updating the version of vtenext, the changes could be lost.

How to move the Business Portal to another host/folder
Update the "portal_url", "vte_url" and "csrf_secret" parameters in the "config/sdk.config.php" file.
Also change the "default_timezone" parameter if the host has a different timezone from the one in which the vte is located. Change the "portal.url" prop to the link pointing to the v2 folder. e.g. https://ticket.vtenext.com/v2​​

Here is the list of parameters supported by the new portal:

API Reference - Main classes, methods, functions and variables

\app\Request

$request->get('foo');
$request->get(['foo', 'bar']);
$request->get('foo', true);

$request->post('foo');
$request->post(['foo', 'bar']);
$request->post('foo', true);

$request->files('attachments');

$request->cookie('foo');

$request->server('');

\app\Response

\app\Session

\app\Config

\app\PortalModule

\app\clients\PortalRestClient

Helpers

Examples

Creating a new controller

Here is an example of how to create a new controller to manage a custom action in the new customer portal.

• Edit "config/sdk.config.php" to insert a new controller

return [
	'sdk_controllers' => [
		'SampleVte' => 'controllers/SampleVteController.php',
	]
];

• Implement the SampleVteController class in "sdk/controllers/SampleVteController.php"

<?php

class SampleVteController extends \app\controllers\BaseController {
	
	public function index($request) {
		return $this->displaySomething($request);
	}

	protected function displaySomething($request) {
		$parameter1 = $request->get('parameter1', true);
		$parameter2 = $request->get('parameter2', true);

		$this->viewer->assign('PARAMETER1', $parameter1);
		$this->viewer->assign('PARAMETER2', $parameter2);

		$layout = \app\LayoutFactory::getPortalLayout($this->viewer, $this->client, $request);
		$output = $this->fetchWithLayout('sdk/SampleVte.tpl', $layout);

		return new \app\Response($output);
	}
	
}

• Create a new template in "resources/templates/sdk/SampleVte.tpl"

{extends file='layouts/PortalLayout.tpl'}

{block name=content}
	<h1>Sample Vte</h1>
{/block}

• Modify "config/sdk.config.php" indicating an sdk file for inserting new entries in the side menu

return [
	'sdk_controllers' => [
		'SampleVte' => 'controllers/SampleVteController.php',
	],
  	'sdk_menu' => [
		'samplevte-menu.php',
	]
];

• Edit the "sdk/samplevte-menu.php" file

<?php

return [
	[
		'text' => trans('SampleVte'),
		'active' => false,
		'prefix' => [
			'type' => 'icon',
			'icon_style' => 'material',
			'icon_name' => 'pie_chart',
		],
		'action' => [
			'type' => 'link',
			'link_href' => "index.php?action=SampleVte",
		],
	],
];

Extending a module

Here is an example of how to extend the functionality of a form in the new customer portal.

• Edit "config/sdk.config.php"

return [
	'sdk_module' => [
		'Contacts' => 'modules/ContactsModule.php',
	]
];

• Implement the ContactsModule class in "sdk/modules/ContactsModule.php"

<?php

class ContactsModule extends \app\PortalModule {
	
	public $hasComments = true;

	public $formColumns = 2;

	public function canAddComments() {
		return true;
	}
	
}