$items All collected bullet strings.
* @return string
*/
protected function render_highlights( array $items ) {
$shown = array_slice( $items, 0, self::HIGHLIGHT_LIMIT );
$remaining = count( $items ) - count( $shown );
$html = '- ' . implode( '
- ', $shown ) . '
';
if ( $remaining > 0 ) {
$html .= '' . sprintf(
/* translators: %d: additional changes not shown. */
_n( '…and %d more change.', '…and %d more changes.', $remaining, 'popup-maker' ),
$remaining
) . '
';
}
return $html;
}
/**
* Extract bullets under a given section heading.
*
* @param string $body Version section body.
* @param string $heading Section heading.
* @return array
*/
protected function extract_bullets( $body, $heading ) {
/*
* The lookahead must accept multi-word bold headings like
* "**Bug Fixes**" or "**Breaking Changes**" — the original
* `[A-Za-z]+` terminated after one word, letting a Features block
* swallow later sections whole.
*/
$pattern = '/\*\*' . preg_quote( $heading, '/' ) . '\*\*(.*?)(?=\*\*[A-Za-z][A-Za-z0-9 \'\-]*\*\*|\z)/s';
if ( ! preg_match( $pattern, $body, $section_match ) ) {
return [];
}
$section = $section_match[1];
$out = [];
if ( preg_match_all( '/^-\s+(.+?)$/m', $section, $bullet_matches ) ) {
foreach ( $bullet_matches[1] as $bullet ) {
$line = trim( $bullet );
if ( '' === $line ) {
continue;
}
// Trim at first sentence break.
if ( preg_match( '/^(.+?[.!?])\s/', $line, $sentence ) ) {
$line = $sentence[1];
}
$line = preg_replace_callback(
'/\[([^\]]+)\]\(([^)]+)\)/',
function ( $m ) {
return '' . esc_html( $m[1] ) . '';
},
$line
);
$out[] = $line;
}
}
return $out;
}
/**
* Path to the plugin's readme.txt file.
*
* @return string
*/
protected function readme_path() {
$path = $this->container->get_path( 'readme.txt' );
return is_string( $path ) ? $path : '';
}
/**
* Build the WordPress plugin-information changelog URL.
*
* `TB_iframe=true` tells WordPress to render the lightweight iframe
* variant of the plugin information screen (no full admin chrome).
* We render this inside our own Modal iframe, so we don't need the
* actual Thickbox JS library on the parent page.
*
* @return string
*/
protected function changelog_url() {
return add_query_arg(
[
'tab' => 'plugin-information',
'plugin' => 'popup-maker',
'section' => 'changelog',
'TB_iframe' => 'true',
'width' => 900,
'height' => 700,
],
self_admin_url( 'plugin-install.php' )
);
}
/**
* Fallback changelog URL for users who can't access the WP plugin
* information screen (no `install_plugins` capability). Opens the
* public changelog on wppopupmaker.com in a new tab.
*
* @return string
*/
protected function public_changelog_url() {
return add_query_arg(
[
'utm_source' => 'pm-notifications',
'utm_medium' => 'panel',
'utm_campaign' => 'whats-new',
],
'https://wppopupmaker.com/changelog/'
);
}
}