Add-ons AIXF Batch Phrase Replace 2.0.6
- Author XenForo
- Creation date
========================================================
FREQUENTLY ASKED QUESTIONS (FAQ):
---------------------------------
Q1: Does this change phrases in all languages?
A: No. You must run it separately for each language you want to modify.
Q2: Can I undo a replacement after I confirm it?
A: No direct undo is possible. You must restore from a backup.
Always review the preview and make a backup before proceeding.
With that being said, you could rerun the addon to change everything back if you are using whole words.
Q3: Where are the CSV logs stored?
A: In: internal_data/batch_phrase_replace/
You can view, download, or delete them from the Logs tab.
Q4: Can I filter by specific add-ons?
A: Yes, choose the add-on from the dropdown to only replace phrases
from that add-on.
Q5: What do the "Match Mode" options mean?
- Contains: Matches anywhere in the phrase text.
- Whole Word: Matches only whole words.
- Exact: Matches the entire phrase text exactly.
Q6: What’s the difference between "Match Case" options?
- Sensitive: Matches only if case matches exactly.
- Insensitive: Matches regardless of case.
Q7: How do I delete old logs?
A: In the Logs tab, click "Delete" for each log or clear them all.
Q8: Can I delete the add-on files from the Admin Panel?
A: Yes, after uninstalling, visit:
admin.php?add-ons/AIXF_BatchPhraseReplace/delete-files
Q9: What happens if my search term is blank?
A: The tool will not run. You must provide a search term.
Q10: Will this work with XenForo 2.2 or older?
A: No. This add-on is tested and supported only on XenForo 2.3+.
Q11: Should I use this on a live forum?
A: Yes and no. Most forum owners should test before doing anything. But I did install this on a live forum without issue.
But please backup.
Q12: How long will it take to change?
A: Depends how many you are doing at a time.
========================================================
IMPORTANT WARNING:
------------------
Phrase replacements can be permanent and may not be undone unless
you restore from a backup. Always back up your database before running
bulk replacements.
# AIXF Batch Phrase Replace — Q&A
Q: How do I protect only certain variables?
A: Switch to List mode and enter base names (no $), one per line. Example lines:
forumTitle
username
user (covers {$user}, {$user.name}, {$user['name']} and {user})
Q: It didn’t replace text inside {forumTitle} — is that expected?
A: Yes. By default (Auto mode) anything inside {...} is protected. To allow changes inside braces for a run, switch to List mode and leave the list empty.
Q: Are printf tokens like %1$s, %02d, or %% protected?
A: Yes. They are always protected in both modes.
Q: Can I run regex replacements?
A: Yes. Provide a full pattern with delimiters, e.g. /\bTitle\b/iu. If a bad pattern is detected, the tool will wrap it as /pattern/u to keep processing.
Q: How can I limit the blast radius?
A: Filter by Language, Add-on, or Scope (admin/public/all) before running Preview.
Q: Where can I find the change log?
A: changelog.txt in the package root contains version notes for 2.0.2+.
Q: Where are logs saved?
A: A CSV is stored under XenForo’s internal data path. The success screen provides the file name and a download button/link.
Q: Can I undo?
A: Use the CSV log to selectively revert phrases manually, or restore from backup. Future versions may add a “revert” helper based on the log file.
[2.0.4]
FREQUENTLY ASKED QUESTIONS (FAQ):
---------------------------------
Q1: Does this change phrases in all languages?
A: No. You must run it separately for each language you want to modify.
Q2: Can I undo a replacement after I confirm it?
A: No direct undo is possible. You must restore from a backup.
Always review the preview and make a backup before proceeding.
With that being said, you could rerun the addon to change everything back if you are using whole words.
Q3: Where are the CSV logs stored?
A: In: internal_data/batch_phrase_replace/
You can view, download, or delete them from the Logs tab.
Q4: Can I filter by specific add-ons?
A: Yes, choose the add-on from the dropdown to only replace phrases
from that add-on.
Q5: What do the "Match Mode" options mean?
- Contains: Matches anywhere in the phrase text.
- Whole Word: Matches only whole words.
- Exact: Matches the entire phrase text exactly.
Q6: What’s the difference between "Match Case" options?
- Sensitive: Matches only if case matches exactly.
- Insensitive: Matches regardless of case.
Q7: How do I delete old logs?
A: In the Logs tab, click "Delete" for each log or clear them all.
Q8: Can I delete the add-on files from the Admin Panel?
A: Yes, after uninstalling, visit:
admin.php?add-ons/AIXF_BatchPhraseReplace/delete-files
Q9: What happens if my search term is blank?
A: The tool will not run. You must provide a search term.
Q10: Will this work with XenForo 2.2 or older?
A: No. This add-on is tested and supported only on XenForo 2.3+.
Q11: Should I use this on a live forum?
A: Yes and no. Most forum owners should test before doing anything. But I did install this on a live forum without issue.
But please backup.
Q12: How long will it take to change?
A: Depends how many you are doing at a time.
========================================================
IMPORTANT WARNING:
------------------
Phrase replacements can be permanent and may not be undone unless
you restore from a backup. Always back up your database before running
bulk replacements.
# AIXF Batch Phrase Replace — Q&A
Q: How do I protect only certain variables?
A: Switch to List mode and enter base names (no $), one per line. Example lines:
forumTitle
username
user (covers {$user}, {$user.name}, {$user['name']} and {user})
Q: It didn’t replace text inside {forumTitle} — is that expected?
A: Yes. By default (Auto mode) anything inside {...} is protected. To allow changes inside braces for a run, switch to List mode and leave the list empty.
Q: Are printf tokens like %1$s, %02d, or %% protected?
A: Yes. They are always protected in both modes.
Q: Can I run regex replacements?
A: Yes. Provide a full pattern with delimiters, e.g. /\bTitle\b/iu. If a bad pattern is detected, the tool will wrap it as /pattern/u to keep processing.
Q: How can I limit the blast radius?
A: Filter by Language, Add-on, or Scope (admin/public/all) before running Preview.
Q: Where can I find the change log?
A: changelog.txt in the package root contains version notes for 2.0.2+.
Q: Where are logs saved?
A: A CSV is stored under XenForo’s internal data path. The success screen provides the file name and a download button/link.
Q: Can I undo?
A: Use the CSV log to selectively revert phrases manually, or restore from backup. Future versions may add a “revert” helper based on the log file.
[2.0.4]
- Added protection for printf-style tokens (%s, %1$s, %02d, %.2f, %%), in both Auto and List modes.
- Changed internal token markers to avoid '%' or '{' so guards cannot collide.