Skip to content
This repository has been archived by the owner on May 21, 2022. It is now read-only.

Mar-tin-G/LocalUrlToText

Repository files navigation

phpBB Local URL To Text extension

This is the repository for the development of the phpBB 3.2 "Local URL To Text" Extension.

Build Status

Description

Replaces local URLs (links to forums, topics, posts or member profiles within your board) with a customizable text.

Examples:

  • If a user of your board posts a link to a forum, it appears as a link like http://yourboard/viewforum.php?f=5.
  • With this extension, the link to the forum is rather displayed as Forum Name.
  • Links to topics can be displayed as Topic Title instead of http://yourboard/viewtopic.php?f=5&t=2.
  • You can also include the name of the forum containing that topic to the link, e.g. Topic Title (Forum Name).
  • Similar text replacements are available for links to posts and to member profile pages.
  • Local links within Custom profile fields can be replaced as well.
  • Supports Pages extension.
  • Works with External Links extension.

The extension only replaces these links when displaying a message (post, private message, etc.). It does not alter the messages that are stored into the database. So when a topic gets renamed, all links to this topic will display the new topic title automatically.

Text replacements

The following replacements are available:

  • For forum or category links: forum/category name
  • For topic links: topic title, forum name of containing forum
  • For post links: poster user name, poster user colour, post subject, topic title, forum name, topic title (only if post subject is empty)
  • For member profile links: user name, user colour
  • For links to pages of the Pages extension: page title
  • Option to enable or disable (default) replacement of local links within Custom profile fields

Authorization

Users will only see content from forums they are authorized to read. E.g. if someone posts a link to a topic that resides in a protected forum, only members with access to this forum will see the title of this topic. Unauthorized members will see the default viewtopic.php?t=xx link.

Installation

  • Download the latest validated release.
  • Extract the downloaded release and copy it to the ext directory of your phpBB board
    • this should result in a ext/martin/localurltotext/ directory
  • Log into your forum and enter the Administration Control Panel.
  • Go to Customise > Extension Management > Manage Extensions.
  • Find Local URL To Text in the list on the right side and click on Enable.
  • Go to Extensions > Local URL To Text > Settings to set up the extension.

Removal

  • Log into your forum and enter the Administration Control Panel.
  • Go to Customise > Extension Management > Manage Extensions.
  • Find Local URL To Text in the list on the right side and click on Disable.
  • To permanently uninstall, click on Delete data and delete the ext/martin/localurltotext/ directory afterwards.

Feedback

Please feel free to post any feedback to the Local URL To Text topic in phpBB's extension community forum.

For bug reports, please open an issue on the extension's GitHub page.

License

GPLv2