MokoSuiteCross/wiki/developer/Adding-Custom-Services.md

Adding Custom Services

MokoSuiteCross uses a plugin-based architecture. Any developer can create a new service plugin.

Plugin Structure

Create a Joomla plugin in the mokosuitecross group:

plg_mokosuitecross_myservice/
├── myservice.xml           # Plugin manifest (group="mokosuitecross")
├── myservice.php           # Legacy stub (empty)
├── src/
│   └── Extension/
│       └── MyserviceService.php   # Implements MokoSuiteCrossServiceInterface
├── services/
│   └── provider.php        # DI container registration
└── language/
    └── en-GB/
        ├── plg_mokosuitecross_myservice.ini
        └── plg_mokosuitecross_myservice.sys.ini

Implement the Interface

Your Extension class must implement MokoSuiteCrossServiceInterface:

namespace Joomla\Plugin\MokoSuiteCross\Myservice\Extension;

use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\Component\MokoSuiteCross\Administrator\Service\MokoSuiteCrossServiceInterface;
use Joomla\Event\SubscriberInterface;

class MyserviceService extends CMSPlugin implements SubscriberInterface, MokoSuiteCrossServiceInterface
{
    public static function getSubscribedEvents(): array
    {
        return ['onMokoSuiteCrossGetServices' => 'onMokoSuiteCrossGetServices'];
    }

    public function onMokoSuiteCrossGetServices(&$services): void
    {
        $services[] = $this;
    }

    public function getServiceType(): string { return 'myservice'; }
    public function getServiceName(): string { return 'My Service'; }
    public function getMaxLength(): int { return 500; }
    public function supportsMedia(): bool { return true; }

    public function publish(string $message, array $media, array $credentials, array $params): array
    {
        // Your API integration here
        return ['success' => true, 'platform_post_id' => '...', 'response' => [...]];
    }

    public function validateCredentials(array $credentials): array
    {
        return ['valid' => true, 'message' => 'OK', 'account_name' => '...'];
    }
}

Required Methods

Method	Returns	Purpose
getServiceType()	string	Unique identifier (lowercase, no spaces)
getServiceName()	string	Display name in admin UI
publish()	array	Send content to the platform
validateCredentials()	array	Test if credentials work
getMaxLength()	int	Character limit (0 = no limit)
supportsMedia()	bool	Whether images can be attached