Addon textexpand #1630

Open

loma-one wants to merge 3 commits from loma-one/friendica-addons:loma-one-patch-1 into 2025.07-rc

loma-one commented

2025-12-23 08:32:35 +01:00

Contributor

TextExpand Addon for Friendica

TextExpand is a performance-oriented addon for the Friendica social network. It automatically collapses long posts in the network stream based on a user-defined character limit, improving stream readability and user experience.
Features

Smart Collapsing: Automatically hides long posts behind a "show more" link.
Bidirectional Toggle: Includes a "show less" link at the end of expanded posts to allow re-collapsing.
HTML5 Safety: Uses advanced DOM parsing to ensure HTML tags (like forum quotes or formatting) are never broken when cutting text.
Multi-byte Safe: Full support for UTF-8 characters, ensuring emojis and special symbols do not cause encoding errors.
User Customizable: Each user can set their own character limit via the settings panel.
Zero JS Overhead: Relies on Friendica's native openClose() function, removing the need for external .js files.

Technical File Documentation & Changes

This section documents the transition from the legacy showmore logic to the modernized TextExpand structure.

textexpand.php (Core Logic)

The backend logic was fully refactored for stability and performance:

Namespace Migration: All functions renamed from showmore_* to textexpand_*.
Reliable Encoding: Implemented a Meta-Tag based UTF-8 injection for DOMDocument to prevent "vanishing text" bugs during parsing.
Visible Length Measurement: The textexpand_get_body_length function now utilizes the textContent property of the DOM body, effectively ignoring HTML tags and measuring only what the user actually reads.
HTML Repair Strategy: The textexpand_cutitem function wraps shortened content in a temporary <div> container. This forces the PHP DOM parser to automatically close any tags opened within the snippet (e.g., inside forum quotes), preventing the layout of the entire page from breaking.

textexpand.css (Styling)

The stylesheet was rewritten to ensure compatibility with modern, responsive Friendica themes:

Block Layout: Forced .textexpand-teaser and .textexpand-content to display: block. This prevents "inline-sticking" where the toggle link appears in the middle of a sentence.
Link Styling: Enhanced the .textexpand-wrap class with bold fonts and specific margins to improve touch-target size for mobile users.
Visual Separation: The .textexpand-less class adds a dashed top border at the end of long posts to visually signal the end of the content.

settings.tpl (User Interface)

The template was updated to sync with the new configuration keys:

ID Synchronization: Updated $enabled and $chars variables to match the new database keys.
Standardized UI: Uses native Friendica CSS classes (settings-block, settings-submit-wrapper) for a seamless look within the admin panel.

TextExpand Addon for Friendica TextExpand is a performance-oriented addon for the Friendica social network. It automatically collapses long posts in the network stream based on a user-defined character limit, improving stream readability and user experience. Features Smart Collapsing: Automatically hides long posts behind a "show more" link. Bidirectional Toggle: Includes a "show less" link at the end of expanded posts to allow re-collapsing. HTML5 Safety: Uses advanced DOM parsing to ensure HTML tags (like forum quotes or formatting) are never broken when cutting text. Multi-byte Safe: Full support for UTF-8 characters, ensuring emojis and special symbols do not cause encoding errors. User Customizable: Each user can set their own character limit via the settings panel. Zero JS Overhead: Relies on Friendica's native openClose() function, removing the need for external .js files. Technical File Documentation & Changes This section documents the transition from the legacy showmore logic to the modernized TextExpand structure. 1. textexpand.php (Core Logic) The backend logic was fully refactored for stability and performance: Namespace Migration: All functions renamed from showmore_* to textexpand_*. Reliable Encoding: Implemented a Meta-Tag based UTF-8 injection for DOMDocument to prevent "vanishing text" bugs during parsing. Visible Length Measurement: The textexpand_get_body_length function now utilizes the textContent property of the DOM body, effectively ignoring HTML tags and measuring only what the user actually reads. HTML Repair Strategy: The textexpand_cutitem function wraps shortened content in a temporary <div> container. This forces the PHP DOM parser to automatically close any tags opened within the snippet (e.g., inside forum quotes), preventing the layout of the entire page from breaking. 2. textexpand.css (Styling) The stylesheet was rewritten to ensure compatibility with modern, responsive Friendica themes: Block Layout: Forced .textexpand-teaser and .textexpand-content to display: block. This prevents "inline-sticking" where the toggle link appears in the middle of a sentence. Link Styling: Enhanced the .textexpand-wrap class with bold fonts and specific margins to improve touch-target size for mobile users. Visual Separation: The .textexpand-less class adds a dashed top border at the end of long posts to visually signal the end of the content. 3. settings.tpl (User Interface) The template was updated to sync with the new configuration keys: ID Synchronization: Updated $enabled and $chars variables to match the new database keys. Standardized UI: Uses native Friendica CSS classes (settings-block, settings-submit-wrapper) for a seamless look within the admin panel.

loma-one added 3 commits

2025-12-23 08:32:36 +01:00

Dateien nach „textexpand“ hochladen f964ccc695

Dateien nach „textexpand/templates“ hochladen 4bd35c8bf6

Dateien nach „textexpand/lang/C“ hochladen aa64481e16

This pull request can be merged automatically.

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u loma-one-patch-1:loma-one-loma-one-patch-1

git switch loma-one-loma-one-patch-1

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch 2025.07-rc

git merge --no-ff loma-one-loma-one-patch-1

git switch loma-one-loma-one-patch-1

git rebase 2025.07-rc

git switch 2025.07-rc

git merge --ff-only loma-one-loma-one-patch-1

git switch loma-one-loma-one-patch-1

git rebase 2025.07-rc

git switch 2025.07-rc

git merge --no-ff loma-one-loma-one-patch-1

git switch 2025.07-rc

git merge --squash loma-one-loma-one-patch-1