Skip to content

Commit bf328d8

Browse files
authored
Update README.md
clarify
1 parent d8ed285 commit bf328d8

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ This extension is known-working in phpBB 3.3.5, and refines code working up to a
6868

6969
## Installation
7070

71-
If you are upgrading from a previous version you **must** disable it first (ACP > tab Customise > Manage extensions > RH Topic Tags ≯ Disable), then remove its files entirely (e.g. move the old `topictags` extension directory to your home directory as a backup), then install the new one, and enable it. Some fairly minimal database changes are needed (should be automatically handled by the migrations files), but the code changes are significant and your board will probably break if you try to overwrite the files in-place. Some of them have moved due to changes in phpBB's namespace security, etc.
71+
If you are upgrading from a previous version you **must** disable it first (ACP > tab Customise > Manage extensions > RH Topic Tags ≯ Disable), then remove its files entirely (e.g. move the old `topictags` extension directory to your home directory as a backup), then install the new one, and enable it, then purge board cache. Some fairly minimal database changes are needed (should be automatically handled by the migrations files), but the code changes are significant and your board will probably break if you try to overwrite the files in-place. Some of them have moved due to changes in phpBB's namespace security, etc.
7272

7373
In the instructions that follow, the directory `ext/` means the phpBB extensions folder under whatever server directory path you used for your phpBB installation. It should be at the same level as your main phpBB installation directory. E.g., if most of phpBB is at `/var/httpd/webdocs/phpbb/` your extensions should be in `/var/httpd/webdocs/ext/` (but that might vary by version; if not found, try instead`/var/httpd/webdocs/phpbb/ext/`). And the path to your website's phpBB files is going to vary widely from system to system, and could be something like `/home/admin/web/yoursitename.com/public_html/phpBB/` or `/serv/web/public/yoursitename/production/phpbb3/` or `/home/yourusername/public_html/phpbb/`. So, check first and adjust the instructions below to compensate.
7474

@@ -248,7 +248,7 @@ If you were already using an old version prior to RH Topic Tags v3.0.2, then the
248248

249249
## Known issues and to-do list
250250

251-
- Migrations files not completed yet; installing and testing this means disabling an old install and removing it, then uploading/checking-out the current version, and re-enabling it, and purging cache.
251+
- Migrations files not completed yet; installing and testing this means disabling an old install and removing its files, then uploading/checking-out the current version, and re-enabling it, and purging board cache.
252252
- Someone on the phpBB forum reported that one or more earlier attempts at updating this extension (attempts on which the present code is partially based) did not work in phpBB 3.3.14 (currrent version as of 2024-12), but they did not provide any debugging information at all, so it's just unknown what the issue might be, or whether it's even an actual issue rather than someone's misconfiguration. No attempts to get this to work under 3.3.13 have been reported yet, only 3.3.5 through 3.3.12.
253253
- The tags created with this extension are not searchable by the built-in search function of phpBB or any known search extension. To search for uses of a tag, you have to go to `https://yoursite.com/tag/tagname` where `tagname` is the name of the tag in question, and as noted near the top of this page there are some simplistic search parameters. There is also no wildcard version of this, just a tag cloud. This means the tagging functionality is of sharply limited utility (especially if you have turned off the tag-cloud feature), so this is something to look into improving.
254254
- Going to `https://yoursite.com/tags/` does not work, only `https://yoursite.com/tags` with no trailing slash, but these URLs canonically should be treated as equivalent. There is a `https://yoursite.com/tags/suggest` page (loading a script that takes data from another, and is used by various functions), so `https://yoursite.com/tags/` does actually exist. Fixing this will have something to do with `controller/main.php`.

0 commit comments

Comments
 (0)