dbFields = array(
'defaultImage' => '',
'twitterSite' => '',
'cardType' => 'summary_large_image'
);
}
public function form()
{
global $L;
$html = '';
$html .= $this->description();
$html .= '
';
$html .= '';
$html .= '';
$html .= '';
$html .= 'Your Twitter @username for twitter:site attribution';
$html .= '
';
$html .= '';
$html .= '';
$html .= '';
$html .= 'Large image cards get better engagement on Twitter';
$html .= '
';
$html .= '';
$html .= '';
$html .= '';
$html .= 'Fallback image when content has no image';
$html .= '
';
return $html;
}
/**
* Sanitize and escape content for use in meta tags
*/
private function sanitize($text, $maxLength = 0)
{
// Strip HTML tags
$text = strip_tags($text);
// Decode HTML entities first to avoid double encoding
$text = html_entity_decode($text, ENT_QUOTES, 'UTF-8');
// Trim whitespace
$text = trim($text);
// Truncate if needed (Twitter has limits)
if ($maxLength > 0 && mb_strlen($text, 'UTF-8') > $maxLength) {
$text = mb_substr($text, 0, $maxLength, 'UTF-8') . '...';
}
// Escape for HTML attribute
return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
}
public function siteHead()
{
global $url;
global $site;
global $WHERE_AM_I;
global $content;
global $page;
$cardType = $this->getValue('cardType');
if (empty($cardType)) {
$cardType = 'summary_large_image';
}
$data = array(
'card' => $cardType,
'site' => $this->getValue('twitterSite'),
'title' => $this->sanitize($site->title(), 70),
'description' => $this->sanitize($site->description(), 200),
'image' => '',
'imageAlt' => ''
);
switch ($WHERE_AM_I) {
case 'page':
$data['title'] = $this->sanitize($page->title(), 70);
// Get description: use page description or fallback to content excerpt
$description = $page->description();
if (empty($description)) {
$description = Text::truncate(strip_tags($page->contentRaw()), 160);
}
$data['description'] = $this->sanitize($description, 200);
$data['image'] = $page->coverImage($absolute = true);
$data['imageAlt'] = $data['title'];
$pageContent = $page->content();
break;
default:
$pageContent = '';
if (Text::isNotEmpty($this->getValue('defaultImage'))) {
$data['image'] = $this->getValue('defaultImage');
} elseif (isset($content[0])) {
$data['image'] = $content[0]->coverImage($absolute = true);
$data['imageAlt'] = $this->sanitize($content[0]->title(), 70);
$pageContent = $content[0]->content();
}
break;
}
// Build HTML output
$html = PHP_EOL . '' . PHP_EOL;
$html .= '' . PHP_EOL;
// Add site handle if configured
if (!empty($data['site'])) {
$html .= '' . PHP_EOL;
}
$html .= '' . PHP_EOL;
$html .= '' . PHP_EOL;
// If the page doesn't have a coverImage try to get an image from the HTML content
if (empty($data['image'])) {
$src = DOM::getFirstImage($pageContent);
if ($src !== false) {
$data['image'] = $src;
} elseif (Text::isNotEmpty($this->getValue('defaultImage'))) {
$data['image'] = $this->getValue('defaultImage');
}
}
// Add image with alt text for accessibility
if (!empty($data['image'])) {
$html .= '' . PHP_EOL;
if (!empty($data['imageAlt'])) {
$html .= '' . PHP_EOL;
}
}
return $html;
}
}