Compare commits

..

2 Commits

Author SHA1 Message Date
gitea-actions[bot] 3f33afd6b2 chore(version): auto-bump patch 01.08.11-dev [skip ci] 2026-06-27 19:51:30 +00:00
jmiller 8700b46e13 feat(#132): add PHPUnit test suite with unit tests
Universal: Auto Version Bump / Version Bump (push) Successful in 8s
Add phpunit.xml.dist, bootstrap, and PSR-4 autoload config. Tests:
- PreviewHelper: 14 tests for platform mockup rendering (skipped when
  PreviewHelper not yet merged from feature/156 branch)
- ServiceIconHelper: 14 tests for icon mapping and HTML rendering
- ServiceInterfaceContract: 7 reflection tests verifying interface
  methods and types, plus 15 plugin implementation checks (skipped
  outside Joomla runtime)

21 tests pass immediately, 29 skip gracefully.

Authored-by: Moko Consulting
2026-06-27 14:50:34 -05:00
10 changed files with 378 additions and 339 deletions
+15 -1
View File
@@ -15,9 +15,23 @@
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.5",
"squizlabs/php_codesniffer": "^3.7",
"phpstan/phpstan": "^1.10",
"joomla/coding-standards": "^4.0"
"joomla/coding-standards": "dev-3.x-dev"
},
"autoload": {
"psr-4": {
"Joomla\\Component\\MokoSuiteCross\\Administrator\\": "source/packages/com_mokosuitecross/src/",
"Joomla\\Component\\MokoSuiteCross\\Site\\": "source/packages/com_mokosuitecross/site/src/",
"Joomla\\Plugin\\Content\\MokoSuiteCross\\": "source/packages/plg_content_mokosuitecross/src/",
"Joomla\\Plugin\\System\\MokoSuiteCross\\": "source/packages/plg_system_mokosuitecross/src/"
}
},
"autoload-dev": {
"psr-4": {
"MokoSuiteCross\\Tests\\": "tests/"
}
},
"config": {
"sort-packages": true
+22
View File
@@ -0,0 +1,22 @@
<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
bootstrap="tests/bootstrap.php"
colors="true"
cacheDirectory=".phpunit.cache"
executionOrder="depends,defects"
failOnRisky="true"
failOnWarning="true">
<testsuites>
<testsuite name="Unit">
<directory>tests/Unit</directory>
</testsuite>
</testsuites>
<source>
<include>
<directory>source/packages/com_mokosuitecross/src</directory>
<directory>source/packages/plg_content_mokosuitecross/src</directory>
<directory>source/packages/plg_system_mokosuitecross/src</directory>
</include>
</source>
</phpunit>
@@ -1,86 +0,0 @@
<?php
/**
* @package MokoSuiteCross
* @subpackage com_mokosuitecross
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoSuiteCross\Administrator\Controller;
defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\MVC\Controller\BaseController;
use Joomla\CMS\Session\Session;
use Joomla\CMS\Uri\Uri;
use Joomla\Component\MokoSuiteCross\Administrator\Helper\CrossPostDispatcher;
use Joomla\Component\MokoSuiteCross\Administrator\Helper\PreviewHelper;
class PreviewController extends BaseController
{
public function render(): void
{
if (!Session::checkToken('get')) {
echo json_encode(['error' => 'Invalid token']);
$this->app->close();
return;
}
$articleId = $this->input->getInt('article_id', 0);
$platform = $this->input->getCmd('platform', 'twitter');
if ($articleId < 1) {
echo json_encode(['error' => 'Missing article ID']);
$this->app->close();
return;
}
$db = Factory::getDbo();
$query = $db->getQuery(true)
->select('*')
->from($db->quoteName('#__content'))
->where($db->quoteName('id') . ' = ' . $articleId);
$db->setQuery($query);
$article = $db->loadObject();
if (!$article) {
echo json_encode(['error' => 'Article not found']);
$this->app->close();
return;
}
$meta = CrossPostDispatcher::buildArticleMeta($article);
$title = $meta['{title}'] ?? '';
$text = $meta['{introtext}'] ?? '';
$url = $meta['{url}'] ?? '';
$imageUrl = $meta['{image}'] ?? '';
$authorName = $meta['{author}'] ?? '';
$supportedPlatforms = PreviewHelper::getSupportedPlatforms();
$html = '';
if ($platform === 'all') {
foreach ($supportedPlatforms as $p) {
$html .= '<div style="margin-bottom:20px;">'
. '<div style="font-weight:600;font-size:13px;color:#666;margin-bottom:6px;text-transform:uppercase;">' . htmlspecialchars(ucfirst($p)) . '</div>'
. PreviewHelper::render($p, $title, $text, $url, $imageUrl, $authorName)
. '</div>';
}
} else {
$html = PreviewHelper::render($platform, $title, $text, $url, $imageUrl, $authorName);
}
$this->app->setHeader('Content-Type', 'text/html; charset=utf-8');
echo $html;
$this->app->close();
}
}
@@ -1,207 +0,0 @@
<?php
/**
* @package MokoSuiteCross
* @subpackage com_mokosuitecross
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace Joomla\Component\MokoSuiteCross\Administrator\Helper;
defined('_JEXEC') or die;
class PreviewHelper
{
public static function render(string $platform, string $title, string $text, string $url, string $imageUrl = '', string $authorName = ''): string
{
$title = htmlspecialchars($title, ENT_QUOTES, 'UTF-8');
$text = htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
$url = htmlspecialchars($url, ENT_QUOTES, 'UTF-8');
$authorName = htmlspecialchars($authorName, ENT_QUOTES, 'UTF-8');
$imageHtml = '';
if (!empty($imageUrl)) {
$imageUrl = htmlspecialchars($imageUrl, ENT_QUOTES, 'UTF-8');
$imageHtml = '<img src="' . $imageUrl . '" alt="" style="width:100%;max-height:260px;object-fit:cover;border-radius:8px;margin:8px 0;">';
}
return match ($platform) {
'twitter' => self::renderTwitter($title, $text, $url, $imageHtml, $authorName),
'facebook' => self::renderFacebook($title, $text, $url, $imageHtml, $authorName),
'mastodon' => self::renderMastodon($title, $text, $url, $imageHtml, $authorName),
'linkedin' => self::renderLinkedIn($title, $text, $url, $imageHtml, $authorName),
'bluesky' => self::renderBluesky($title, $text, $url, $imageHtml, $authorName),
'telegram' => self::renderTelegram($title, $text, $url, $imageHtml),
default => self::renderGeneric($platform, $title, $text, $url, $imageHtml),
};
}
public static function getSupportedPlatforms(): array
{
return ['twitter', 'facebook', 'mastodon', 'linkedin', 'bluesky', 'telegram'];
}
private static function renderTwitter(string $title, string $text, string $url, string $imageHtml, string $author): string
{
$displayText = !empty($text) ? $text : $title;
$charCount = mb_strlen(strip_tags($displayText));
return <<<HTML
<div style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;max-width:500px;border:1px solid #cfd9de;border-radius:16px;padding:12px 16px;background:#fff;">
<div style="display:flex;align-items:center;margin-bottom:8px;">
<div style="width:40px;height:40px;border-radius:50%;background:#1da1f2;margin-right:10px;display:flex;align-items:center;justify-content:center;color:#fff;font-weight:bold;font-size:16px;">X</div>
<div>
<div style="font-weight:700;font-size:15px;color:#0f1419;">{$author}</div>
<div style="color:#536471;font-size:13px;">@username</div>
</div>
</div>
<div style="font-size:15px;line-height:1.4;color:#0f1419;margin-bottom:8px;">{$displayText}</div>
{$imageHtml}
<div style="margin-top:8px;padding:10px 12px;border:1px solid #cfd9de;border-radius:12px;background:#f7f9f9;">
<div style="font-size:13px;color:#536471;margin-bottom:2px;">yoursite.com</div>
<div style="font-size:15px;font-weight:600;color:#0f1419;">{$title}</div>
</div>
<div style="color:#536471;font-size:13px;margin-top:8px;text-align:right;">{$charCount}/280</div>
</div>
HTML;
}
private static function renderFacebook(string $title, string $text, string $url, string $imageHtml, string $author): string
{
$displayText = !empty($text) ? $text : $title;
return <<<HTML
<div style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;max-width:500px;border:1px solid #dddfe2;border-radius:8px;background:#fff;overflow:hidden;">
<div style="padding:12px 16px;">
<div style="display:flex;align-items:center;margin-bottom:8px;">
<div style="width:40px;height:40px;border-radius:50%;background:#1877f2;margin-right:10px;display:flex;align-items:center;justify-content:center;color:#fff;font-weight:bold;font-size:18px;">f</div>
<div>
<div style="font-weight:600;font-size:15px;color:#050505;">{$author}</div>
<div style="color:#65676b;font-size:13px;">Just now</div>
</div>
</div>
<div style="font-size:15px;line-height:1.4;color:#050505;">{$displayText}</div>
</div>
{$imageHtml}
<div style="padding:10px 16px;border-top:1px solid #dddfe2;background:#f0f2f5;">
<div style="font-size:12px;color:#65676b;text-transform:uppercase;">yoursite.com</div>
<div style="font-size:16px;font-weight:600;color:#050505;margin-top:2px;">{$title}</div>
</div>
</div>
HTML;
}
private static function renderMastodon(string $title, string $text, string $url, string $imageHtml, string $author): string
{
$displayText = !empty($text) ? $text : $title;
$charCount = mb_strlen(strip_tags($displayText));
return <<<HTML
<div style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;max-width:500px;border:1px solid #c0cdd9;border-radius:8px;padding:14px 16px;background:#fff;">
<div style="display:flex;align-items:center;margin-bottom:10px;">
<div style="width:46px;height:46px;border-radius:8px;background:#6364ff;margin-right:10px;display:flex;align-items:center;justify-content:center;color:#fff;font-weight:bold;font-size:20px;">M</div>
<div>
<div style="font-weight:700;font-size:15px;color:#1a1a2e;">{$author}</div>
<div style="color:#606984;font-size:13px;">@user@mastodon.social</div>
</div>
</div>
<div style="font-size:15px;line-height:1.5;color:#1a1a2e;">{$displayText}</div>
{$imageHtml}
<div style="margin-top:8px;padding:10px 12px;border:1px solid #c0cdd9;border-radius:8px;background:#f2f5f7;">
<div style="font-size:14px;font-weight:600;color:#1a1a2e;">{$title}</div>
<div style="font-size:12px;color:#606984;margin-top:2px;">yoursite.com</div>
</div>
<div style="color:#606984;font-size:13px;margin-top:8px;text-align:right;">{$charCount}/500</div>
</div>
HTML;
}
private static function renderLinkedIn(string $title, string $text, string $url, string $imageHtml, string $author): string
{
$displayText = !empty($text) ? $text : $title;
return <<<HTML
<div style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;max-width:500px;border:1px solid #e0dfdc;border-radius:8px;background:#fff;overflow:hidden;">
<div style="padding:12px 16px;">
<div style="display:flex;align-items:center;margin-bottom:8px;">
<div style="width:48px;height:48px;border-radius:50%;background:#0a66c2;margin-right:10px;display:flex;align-items:center;justify-content:center;color:#fff;font-weight:bold;font-size:18px;">in</div>
<div>
<div style="font-weight:600;font-size:14px;color:#191919;">{$author}</div>
<div style="color:#666;font-size:12px;">Just now</div>
</div>
</div>
<div style="font-size:14px;line-height:1.4;color:#191919;">{$displayText}</div>
</div>
{$imageHtml}
<div style="padding:8px 16px 12px;border-top:1px solid #e0dfdc;background:#f9fafb;">
<div style="font-size:14px;font-weight:600;color:#191919;">{$title}</div>
<div style="font-size:12px;color:#666;margin-top:2px;">yoursite.com</div>
</div>
</div>
HTML;
}
private static function renderBluesky(string $title, string $text, string $url, string $imageHtml, string $author): string
{
$displayText = !empty($text) ? $text : $title;
$charCount = mb_strlen(strip_tags($displayText));
return <<<HTML
<div style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;max-width:500px;border:1px solid #d1d5db;border-radius:12px;padding:12px 16px;background:#fff;">
<div style="display:flex;align-items:center;margin-bottom:8px;">
<div style="width:42px;height:42px;border-radius:50%;background:#0085ff;margin-right:10px;display:flex;align-items:center;justify-content:center;color:#fff;font-weight:bold;font-size:16px;">B</div>
<div>
<div style="font-weight:600;font-size:15px;color:#1e2937;">{$author}</div>
<div style="color:#6b7280;font-size:13px;">@user.bsky.social</div>
</div>
</div>
<div style="font-size:15px;line-height:1.4;color:#1e2937;">{$displayText}</div>
{$imageHtml}
<div style="margin-top:8px;padding:10px 12px;border:1px solid #d1d5db;border-radius:8px;background:#f9fafb;">
<div style="font-size:14px;font-weight:600;color:#1e2937;">{$title}</div>
<div style="font-size:12px;color:#6b7280;margin-top:2px;">yoursite.com</div>
</div>
<div style="color:#6b7280;font-size:13px;margin-top:8px;text-align:right;">{$charCount}/300</div>
</div>
HTML;
}
private static function renderTelegram(string $title, string $text, string $url, string $imageHtml): string
{
$displayText = !empty($text) ? $text : $title;
return <<<HTML
<div style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;max-width:500px;background:#effdde;border-radius:12px;padding:10px 14px;margin-left:60px;">
{$imageHtml}
<div style="font-size:15px;line-height:1.4;color:#000;">{$displayText}</div>
<div style="margin-top:8px;padding:8px 12px;border-left:3px solid #4fae4e;background:#fff;border-radius:0 8px 8px 0;">
<div style="font-size:14px;font-weight:600;color:#000;">{$title}</div>
<div style="font-size:12px;color:#888;margin-top:2px;">yoursite.com</div>
</div>
<div style="color:#5fb452;font-size:11px;text-align:right;margin-top:4px;">Just now</div>
</div>
HTML;
}
private static function renderGeneric(string $platform, string $title, string $text, string $url, string $imageHtml): string
{
$platformLabel = htmlspecialchars(ucfirst($platform), ENT_QUOTES, 'UTF-8');
$displayText = !empty($text) ? $text : $title;
return <<<HTML
<div style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;max-width:500px;border:1px solid #ddd;border-radius:8px;padding:12px 16px;background:#fff;">
<div style="font-weight:600;font-size:13px;color:#666;margin-bottom:8px;text-transform:uppercase;">{$platformLabel}</div>
<div style="font-size:15px;line-height:1.4;color:#333;">{$displayText}</div>
{$imageHtml}
<div style="margin-top:8px;padding:8px 12px;border:1px solid #ddd;border-radius:6px;background:#f9f9f9;">
<div style="font-size:14px;font-weight:600;color:#333;">{$title}</div>
<div style="font-size:12px;color:#999;">yoursite.com</div>
</div>
</div>
HTML;
}
}
@@ -31,6 +31,3 @@ PLG_CONTENT_MOKOSUITECROSS_SHARE_IMAGE_CUSTOM="Custom Image"
PLG_CONTENT_MOKOSUITECROSS_SHARE_IMAGE_NONE="No Image"
PLG_CONTENT_MOKOSUITECROSS_CUSTOM_IMAGE="Custom Share Image"
PLG_CONTENT_MOKOSUITECROSS_CUSTOM_IMAGE_DESC="Select an image from the media manager to use for cross-posting."
PLG_CONTENT_MOKOSUITECROSS_FIELDSET_PREVIEW="Social Preview"
PLG_CONTENT_MOKOSUITECROSS_PREVIEW="Preview Post"
@@ -19,7 +19,6 @@ use Joomla\CMS\Factory;
use Joomla\CMS\Form\Form;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Session\Session;
use Joomla\CMS\Uri\Uri;
use Joomla\Component\MokoSuiteCross\Administrator\Helper\CrossPostDispatcher;
use Joomla\Event\SubscriberInterface;
@@ -266,47 +265,6 @@ XML;
$form->load($historyXml);
$form->setFieldAttribute('mokosuitecross_history', 'description', $historyHtml, 'attribs');
}
// Social Preview panel (#156)
$token = Session::getFormToken();
$previewUrl = Uri::base() . 'index.php?option=com_mokosuitecross&task=preview.render&format=raw&article_id=' . $articleId . '&' . $token . '=1';
$previewButtonHtml = '<div id="mokosuitecross-preview-panel">'
. '<div class="mb-2">'
. '<select id="mokosuitecross-preview-platform" class="form-select form-select-sm" style="width:auto;display:inline-block;">'
. '<option value="all">All Platforms</option>'
. '<option value="twitter">X / Twitter</option>'
. '<option value="facebook">Facebook</option>'
. '<option value="linkedin">LinkedIn</option>'
. '<option value="mastodon">Mastodon</option>'
. '<option value="bluesky">Bluesky</option>'
. '<option value="telegram">Telegram</option>'
. '</select> '
. '<button type="button" class="btn btn-sm btn-outline-primary" onclick="mokosuitecrossLoadPreview()">'
. '<span class="icon-eye" aria-hidden="true"></span> Preview</button>'
. '</div>'
. '<div id="mokosuitecross-preview-output" style="max-height:600px;overflow-y:auto;"></div>'
. '</div>'
. '<script>'
. 'function mokosuitecrossLoadPreview(){'
. 'var p=document.getElementById("mokosuitecross-preview-platform").value;'
. 'var o=document.getElementById("mokosuitecross-preview-output");'
. 'o.innerHTML="<div class=\"text-center p-3\"><span class=\"spinner-border spinner-border-sm\"></span> Loading...</div>";'
. 'fetch("' . $previewUrl . '&platform="+p)'
. '.then(function(r){return r.text();})'
. '.then(function(h){o.innerHTML=h;})'
. '.catch(function(){o.innerHTML="<div class=\"alert alert-danger\">Preview failed</div>";});'
. '}'
. '</script>';
$previewXml = '<?xml version="1.0"?>
<form><fields name="attribs"><fieldset name="mokosuitecross_preview" label="PLG_CONTENT_MOKOSUITECROSS_FIELDSET_PREVIEW">
<field name="mokosuitecross_preview_panel" type="note"
label="PLG_CONTENT_MOKOSUITECROSS_PREVIEW"
description="" />
</fieldset></fields></form>';
$form->load($previewXml);
$form->setFieldAttribute('mokosuitecross_preview_panel', 'description', $previewButtonHtml, 'attribs');
}
}
+128
View File
@@ -0,0 +1,128 @@
<?php
/**
* @package MokoSuiteCross
* @subpackage Tests
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace MokoSuiteCross\Tests\Unit\Helper;
use Joomla\Component\MokoSuiteCross\Administrator\Helper\PreviewHelper;
use PHPUnit\Framework\Attributes\RequiresMethod;
use PHPUnit\Framework\TestCase;
#[RequiresMethod(PreviewHelper::class, 'render')]
class PreviewHelperTest extends TestCase
{
public function testRenderTwitterContainsCharCount(): void
{
$html = PreviewHelper::render('twitter', 'Test Title', 'Hello world', 'https://example.com', '', 'Author');
$this->assertStringContainsString('11/280', $html);
}
public function testRenderTwitterEscapesHtml(): void
{
$html = PreviewHelper::render('twitter', '<script>alert(1)</script>', 'text', 'https://example.com');
$this->assertStringNotContainsString('<script>', $html);
$this->assertStringContainsString('&lt;script&gt;', $html);
}
public function testRenderFacebookContainsAuthor(): void
{
$html = PreviewHelper::render('facebook', 'My Article', 'Intro text here', 'https://example.com', '', 'John Doe');
$this->assertStringContainsString('John Doe', $html);
$this->assertStringContainsString('My Article', $html);
}
public function testRenderMastodonContainsCharCount(): void
{
$html = PreviewHelper::render('mastodon', 'Title', 'Post text', 'https://example.com', '', 'Author');
$this->assertStringContainsString('9/500', $html);
}
public function testRenderBlueskyContainsCharCount(): void
{
$html = PreviewHelper::render('bluesky', 'Title', 'A bluesky post', 'https://example.com', '', 'Author');
$this->assertStringContainsString('14/300', $html);
}
public function testRenderLinkedInContainsAuthor(): void
{
$html = PreviewHelper::render('linkedin', 'Article', 'Text', 'https://example.com', '', 'Jane Smith');
$this->assertStringContainsString('Jane Smith', $html);
}
public function testRenderTelegramDoesNotShowAuthor(): void
{
$html = PreviewHelper::render('telegram', 'Article', 'Message text', 'https://example.com');
$this->assertStringContainsString('Message text', $html);
$this->assertStringContainsString('Article', $html);
}
public function testRenderWithImageIncludesImgTag(): void
{
$html = PreviewHelper::render('twitter', 'Title', 'Text', 'https://example.com', 'https://example.com/image.jpg', 'Author');
$this->assertStringContainsString('<img src="https://example.com/image.jpg"', $html);
}
public function testRenderWithoutImageOmitsImgTag(): void
{
$html = PreviewHelper::render('twitter', 'Title', 'Text', 'https://example.com', '', 'Author');
$this->assertStringNotContainsString('<img', $html);
}
public function testRenderGenericPlatform(): void
{
$html = PreviewHelper::render('pinterest', 'Title', 'Text', 'https://example.com');
$this->assertStringContainsString('PINTEREST', $html);
$this->assertStringContainsString('Title', $html);
}
public function testGetSupportedPlatformsReturnsSix(): void
{
$platforms = PreviewHelper::getSupportedPlatforms();
$this->assertCount(6, $platforms);
$this->assertContains('twitter', $platforms);
$this->assertContains('facebook', $platforms);
$this->assertContains('mastodon', $platforms);
$this->assertContains('linkedin', $platforms);
$this->assertContains('bluesky', $platforms);
$this->assertContains('telegram', $platforms);
}
public function testRenderUsesTextWhenProvided(): void
{
$html = PreviewHelper::render('facebook', 'My Title', 'Custom intro text', 'https://example.com');
$this->assertStringContainsString('Custom intro text', $html);
}
public function testRenderFallsBackToTitleWhenTextEmpty(): void
{
$html = PreviewHelper::render('facebook', 'Fallback Title', '', 'https://example.com');
$this->assertMatchesRegularExpression('/Fallback Title.*Fallback Title/s', $html);
}
public function testImageUrlIsEscaped(): void
{
$html = PreviewHelper::render('twitter', 'Title', 'Text', 'https://example.com', 'https://example.com/img?a=1&b=2', 'Author');
$this->assertStringContainsString('https://example.com/img?a=1&amp;b=2', $html);
}
}
@@ -0,0 +1,69 @@
<?php
/**
* @package MokoSuiteCross
* @subpackage Tests
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace MokoSuiteCross\Tests\Unit\Helper;
use Joomla\Component\MokoSuiteCross\Administrator\Helper\ServiceIconHelper;
use PHPUnit\Framework\TestCase;
class ServiceIconHelperTest extends TestCase
{
/**
* @dataProvider knownServiceTypesProvider
*/
public function testGetIconReturnsKnownIcon(string $serviceType, string $expectedIcon): void
{
$this->assertSame($expectedIcon, ServiceIconHelper::getIcon($serviceType));
}
public static function knownServiceTypesProvider(): array
{
return [
'facebook' => ['facebook', 'icon-facebook'],
'twitter' => ['twitter', 'icon-twitter'],
'linkedin' => ['linkedin', 'icon-linkedin'],
'mastodon' => ['mastodon', 'icon-globe'],
'bluesky' => ['bluesky', 'icon-cloud'],
'telegram' => ['telegram', 'icon-paper-plane'],
'discord' => ['discord', 'icon-headset'],
'slack' => ['slack', 'icon-hashtag'],
'mailchimp' => ['mailchimp', 'icon-envelope'],
'medium' => ['medium', 'icon-book'],
];
}
public function testGetIconReturnsFallbackForUnknownType(): void
{
$this->assertSame('icon-share-alt', ServiceIconHelper::getIcon('unknown_platform'));
}
public function testRenderIconOutputsSpanElement(): void
{
$html = ServiceIconHelper::renderIcon('facebook');
$this->assertSame('<span class="icon-facebook" aria-hidden="true"></span>', $html);
}
public function testRenderIconWithExtraClass(): void
{
$html = ServiceIconHelper::renderIcon('twitter', 'me-1 text-info');
$this->assertSame('<span class="icon-twitter me-1 text-info" aria-hidden="true"></span>', $html);
}
public function testRenderIconEscapesExtraClass(): void
{
$html = ServiceIconHelper::renderIcon('facebook', '"><script>');
$this->assertStringNotContainsString('<script>', $html);
$this->assertStringContainsString('&quot;&gt;&lt;script&gt;', $html);
}
}
@@ -0,0 +1,128 @@
<?php
/**
* @package MokoSuiteCross
* @subpackage Tests
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
* SPDX-License-Identifier: GPL-3.0-or-later
*/
namespace MokoSuiteCross\Tests\Unit\Service;
use Joomla\Component\MokoSuiteCross\Administrator\Service\MokoSuiteCrossServiceInterface;
use PHPUnit\Framework\TestCase;
class ServiceInterfaceContractTest extends TestCase
{
public function testInterfaceExists(): void
{
$this->assertTrue(interface_exists(MokoSuiteCrossServiceInterface::class));
}
public function testInterfaceDefinesRequiredMethods(): void
{
$reflection = new \ReflectionClass(MokoSuiteCrossServiceInterface::class);
$expectedMethods = [
'getServiceType',
'getServiceName',
'publish',
'validateCredentials',
'getMaxLength',
'supportsMedia',
'getSupportedMediaTypes',
];
foreach ($expectedMethods as $method) {
$this->assertTrue(
$reflection->hasMethod($method),
"Interface missing method: {$method}"
);
}
}
public function testGetServiceTypeReturnsString(): void
{
$method = new \ReflectionMethod(MokoSuiteCrossServiceInterface::class, 'getServiceType');
$returnType = $method->getReturnType();
$this->assertNotNull($returnType);
$this->assertSame('string', $returnType->getName());
}
public function testPublishAcceptsCorrectParameters(): void
{
$method = new \ReflectionMethod(MokoSuiteCrossServiceInterface::class, 'publish');
$params = $method->getParameters();
$this->assertCount(4, $params);
$this->assertSame('message', $params[0]->getName());
$this->assertSame('media', $params[1]->getName());
$this->assertSame('credentials', $params[2]->getName());
$this->assertSame('params', $params[3]->getName());
}
public function testPublishReturnsArray(): void
{
$method = new \ReflectionMethod(MokoSuiteCrossServiceInterface::class, 'publish');
$returnType = $method->getReturnType();
$this->assertNotNull($returnType);
$this->assertSame('array', $returnType->getName());
}
public function testGetMaxLengthReturnsInt(): void
{
$method = new \ReflectionMethod(MokoSuiteCrossServiceInterface::class, 'getMaxLength');
$returnType = $method->getReturnType();
$this->assertNotNull($returnType);
$this->assertSame('int', $returnType->getName());
}
public function testSupportsMediaReturnsBool(): void
{
$method = new \ReflectionMethod(MokoSuiteCrossServiceInterface::class, 'supportsMedia');
$returnType = $method->getReturnType();
$this->assertNotNull($returnType);
$this->assertSame('bool', $returnType->getName());
}
/**
* @dataProvider servicePluginClassProvider
*/
public function testServicePluginImplementsInterface(string $className): void
{
if (!class_exists($className)) {
$this->markTestSkipped("Class {$className} not autoloadable (needs Joomla runtime)");
}
$this->assertTrue(
is_subclass_of($className, MokoSuiteCrossServiceInterface::class),
"{$className} does not implement MokoSuiteCrossServiceInterface"
);
}
public static function servicePluginClassProvider(): array
{
$plugins = [
'facebook', 'twitter', 'linkedin', 'mastodon', 'bluesky',
'telegram', 'discord', 'slack', 'mailchimp', 'medium',
'instagram', 'youtube', 'threads', 'pinterest', 'reddit',
];
$cases = [];
foreach ($plugins as $plugin) {
$class = ucfirst($plugin);
$cases[$plugin] = [
"Joomla\\Plugin\\MokoSuiteCross\\{$class}\\Extension\\{$class}Service",
];
}
return $cases;
}
}
+16
View File
@@ -0,0 +1,16 @@
<?php
/**
* @package MokoSuiteCross
* @subpackage Tests
* @author Moko Consulting <hello@mokoconsulting.tech>
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE
* SPDX-License-Identifier: GPL-3.0-or-later
*/
require_once __DIR__ . '/../vendor/autoload.php';
if (!defined('_JEXEC')) {
define('_JEXEC', 1);
}