README

A phpBB extension that displays a short excerpt of text from the first post in a tooltip while the mouse hovers over a topic’s title.

Features

• Let your visitors peek at what's inside a topic before they click on it
• NEW in v2.4: Full HTML rendering for rich content display
• NEW in v2.4: Scrollable topic previews with hoverable content area for large media and embedded content
• NEW in v2.4: Admin option to toggle topic previews between rich topic previews for the best UX or classic plain text
• NEW in v2.4: Admin option to toggle parsing attachments for display in rich topic previews
• Admin options to display user avatars and text previews from the first and last posts
• Admin option to set the amount of text shown in the preview
• Admin option to remove BBCodes, whose contents you do not want displayed in the topic preview
• Admin options to customize the appearance and assign different themes to board styles
• Ships with four themes, additional custom themes can be added using CSS files
• User option allows users to disable topic previews
• Previews are aware of the browser window top / bottom edges and are responsive
• The last word in the topic preview is not cut off and will be followed by an ellipsis
• Character limits apply safe HTML trimming that preserves tag structure and prevents broken markup
• Multiple languages are supported. View the pre-installed localizations.
• Built-in support for "Precise Similar Topics", "Recent Topics" and "Top Five" extensions

Awards

• Featured MOD of the Week in the phpBB Weekly Podcast, episode #143.

Minimum Requirements

• phpBB 3.3.0 or higher
• PHP 7.2 or higher

Installation

1. Download the latest validated release.
2. Unzip the downloaded release and copy it to the ext directory of your phpBB board.
3. Navigate in the ACP to Customise -> Manage extensions.
4. Look for Topic Preview under the Disabled Extensions list and click its Enable link.

Uninstallation

1. Navigate in the ACP to Customise -> Manage extensions.
2. Click the Disable link for Topic Preview.
3. To permanently uninstall, click Delete Data, then delete the topicpreview folder from phpBB/ext/vse/.

Support

Support is available for Topic Preview in the phpBB Extension Database.

Changelog

License

GNU General Public License v2

© 2013 - 2024 Matt Friedman