75 lines
2.5 KiB
Markdown
75 lines
2.5 KiB
Markdown
|
# Adding Custom Services
|
||
|
|
|
||
|
|
MokoJoomCross uses a plugin-based architecture. Any developer can create a new service plugin.
|
||
|
|
|
||
|
|
## Plugin Structure
|
||
|
|
|
||
|
|
Create a Joomla plugin in the `mokojoomcross` group:
|
||
|
|
|
||
|
|
```
|
||
|
|
plg_mokojoomcross_myservice/
|
||
|
|
├── myservice.xml # Plugin manifest (group="mokojoomcross")
|
||
|
|
├── myservice.php # Legacy stub (empty)
|
||
|
|
├── src/
|
||
|
|
│ └── Extension/
|
||
|
|
│ └── MyserviceService.php # Implements MokoJoomCrossServiceInterface
|
||
|
|
├── services/
|
||
|
|
│ └── provider.php # DI container registration
|
||
|
|
└── language/
|
||
|
|
└── en-GB/
|
||
|
|
├── plg_mokojoomcross_myservice.ini
|
||
|
|
└── plg_mokojoomcross_myservice.sys.ini
|
||
|
|
```
|
||
|
|
|
||
|
|
## Implement the Interface
|
||
|
|
|
||
|
|
Your Extension class must implement `MokoJoomCrossServiceInterface`:
|
||
|
|
|
||
|
|
```php
|
||
|
|
namespace Joomla\Plugin\MokoJoomCross\Myservice\Extension;
|
||
|
|
|
||
|
|
use Joomla\CMS\Plugin\CMSPlugin;
|
||
|
|
use Joomla\Component\MokoJoomCross\Administrator\Service\MokoJoomCrossServiceInterface;
|
||
|
|
use Joomla\Event\SubscriberInterface;
|
||
|
|
|
||
|
|
class MyserviceService extends CMSPlugin implements SubscriberInterface, MokoJoomCrossServiceInterface
|
||
|
|
{
|
||
|
|
public static function getSubscribedEvents(): array
|
||
|
|
{
|
||
|
|
return ['onMokoJoomCrossGetServices' => 'onMokoJoomCrossGetServices'];
|
||
|
|
}
|
||
|
|
|
||
|
|
public function onMokoJoomCrossGetServices(&$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 |
|