';
$table = 'head';
}
$tag = 'head' === $table ? 'th' : 'td';
$html .= '';
foreach (explode('|', substr($trim, 1, -1)) as $cell) {
$html .= '<' . $tag . '>' . self::inline(trim($cell)) . '';
}
$html .= '
';
continue;
}
if (preg_match('/^[-*]\s+(.+)$/', $trim, $m) || preg_match('/^\d+\.\s+(.+)$/', $trim, $n)) {
$type = isset($n[1]) ? 'ol' : 'ul';
$text = isset($n[1]) ? $n[1] : $m[1];
if ($list !== $type) {
$close_list();
$html .= '<' . $type . '>';
$list = $type;
}
$html .= '' . self::inline($text) . '';
unset($n);
continue;
}
$close_list();
$html .= '' . self::inline($trim) . '
';
}
$close_list();
return $html;
}
/**
* Heading ID as GitHub makes it, so README links such as
* `[Credits](#credits)` work in the tab too. Repeats get -1, -2...
*
* @param string $text Heading Markdown.
* @param array $ids IDs used so far (updated).
* @return string ID.
*/
private static function anchor($text, array &$ids) {
$text = preg_replace('/\[([^\]]+)\]\([^)]*\)/', '$1', $text);
$text = str_replace(array('`', '*'), '', $text);
$id = function_exists('mb_strtolower') ? mb_strtolower($text, 'UTF-8') : strtolower($text);
$id = preg_replace('/[^\p{L}\p{N}\s_-]/u', '', $id);
$id = preg_replace('/\s/u', '-', trim($id));
$base = '' === $id ? 'section' : $id;
$id = $base;
$n = 0;
while (isset($ids[$id])) {
$id = $base . '-' . (++$n);
}
$ids[$id] = true;
return $id;
}
/**
* An image from the plugin's folder, such as the banner at the top of
* README.md. Only relative paths to image files that exist are shown, so
* the tab never loads anything from another site.
*
* @param string $path Path relative to the plugin folder.
* @param string $alt Alternative text.
* @return string HTML, or '' for anything else.
*/
private static function image($path, $alt) {
if (!preg_match('#^[A-Za-z0-9_-]+(?:/[A-Za-z0-9_-]+)*\.(?:svg|png|jpe?g|gif|webp)$#i', $path)) {
return '';
}
$file = WPSTARTER_DIR . $path;
if (!is_file($file)) {
return '';
}
// Width and height stop the page jumping while the image loads.
$size = '';
if ('svg' === strtolower(pathinfo($path, PATHINFO_EXTENSION))) {
$head = (string) file_get_contents($file, false, null, 0, 2048); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents -- local file.
if (preg_match('/]*?\swidth="(\d+)"[^>]*?\sheight="(\d+)"/', $head, $m)) {
$size = array((int) $m[1], (int) $m[2]);
}
} else {
$size = wp_getimagesize($file);
}
$dims = is_array($size) && !empty($size[0]) && !empty($size[1])
? sprintf(' width="%d" height="%d"', $size[0], $size[1])
: '';
// The file's time in the address, so browsers fetch a changed image
// (such as a new banner after an update) instead of a cached one.
$url = add_query_arg('ver', (string) filemtime($file), WPSTARTER_URL . $path);
return sprintf(
'
',
esc_url($url),
esc_attr($alt),
$dims
);
}
/**
* Inline Markdown on escaped text.
*
* @param string $text Raw text.
* @return string HTML.
*/
private static function inline($text) {
$text = esc_html($text);
$text = preg_replace('/`([^`]+)`/', '$1', $text);
$text = preg_replace('/\*\*(.+?)\*\*/', '$1', $text);
$text = preg_replace('/(?$1', $text);
return preg_replace_callback('/\[([^\]]+)\]\(([^)\s]+)\)/', function ($m) {
$url = esc_url(html_entity_decode($m[2]), array('http', 'https'));
if ('#' === $m[2][0]) {
return sprintf('%2$s', esc_attr(substr($m[2], 1)), $m[1]);
}
if ('' === $url) {
return $m[1];
}
return sprintf('%2$s', $url, $m[1]);
}, $text);
}
}