|
1 | 1 | # SMF Tools repository |
2 | 2 |
|
3 | 3 | This repository contains a few useful scripts for SMF, such as install/upgrade or repair scripts, database cleaning up, etc. |
4 | | -All scripts in this repository are under BSD 3-clause license, unless specified otherwise. |
5 | | - |
6 | | -# Tool explanation |
7 | | - |
8 | | -* **databasecleanup** |
9 | | -* **install_script**: a (nice I hope :P) template that can be used to create manual installation scripts for mods. At the moment the hook part is fully working, the database part is still WIP. |
10 | | -* **ban_script.php**: a script that allows perform multiple user banning at once. You can provide a list of usernames that you want to ban or you can ask the script to scan a board you have collected all the users you want to ban in (the name must be the subject of the topic). |
11 | | -* **fix_packages.php**: with SMF 2.0 after a large upgrade (to cleanup forum, not after an upgrade from SMF 1.x) the mods are still marked as installed, with this script you can invert that state. |
12 | | -* **Populate.php**: a script that can be used to populate a forum with dummy users (usually useful for testing), originaly written by [SlammedDime](http://code.mattzuba.com/populator) |
13 | | -* **repair_settings.php**: updated version of repair_settings.php it supports multiple attachments directory, fix several other problems... oh I don't remember everything! :P |
14 | | -* **smfinfo.php** |
15 | | -* **status.php** |
16 | | -* **webinstall.php** |
17 | 4 |
|
18 | | -# Tools download |
| 5 | +All scripts in this repository are under BSD 3-clause license, unless specified otherwise. |
| 6 | +File|Description |
| 7 | +---|--- |
| 8 | +**databasecleanup**|Analyses a database and compares it to a fresh install. Displays added settings and columns with options to remove. |
| 9 | +**install_script**|A template that can be used to create manual installation scripts for mods. At the moment the hook part is fully working, the database part is still WIP. |
| 10 | +**ban_script.php**|A script that allows perform multiple user banning at once. You can provide a list of usernames that you want to ban or you can ask the script to scan a board you have collected all the users you want to ban in (the name must be the subject of the topic). |
| 11 | +**fix_packages.php**|After a large upgrade (to cleanup forum) the mods are still marked as installed, with this script you can invert that state. |
| 12 | +**Populate.php**|a script that can be used to populate a forum with dummy users (usually useful for testing), originaly written by [SlammedDime](http://code.mattzuba.com/populator) |
| 13 | +**repair_settings.php**|A script that can detect the correct value for a number of fields and settings on your forum. Useful to fix broken installs. |
| 14 | +**smfinfo.php**|A script that will provide detailed information to help with support issues. Output includes details of the system, PHP, file versions, database, error log, and mods installed. Can provide password access to output for trusted users. |
| 15 | +**status.php**|A script that can be used to analyse your database performance and provide suggestions on how to improve settings (experimental) |
| 16 | + |
| 17 | +### Tools download |
19 | 18 |
|
20 | 19 | Apart from cloning the repo, you can find the files more useful to end-users at the [download page](https://github.com/emanuele45/tools/downloads) |
21 | 20 |
|
22 | | -# SMF Tools repository |
23 | | - |
24 | | -This repository contains a few useful scripts for SMF, such as install/upgrade or repair scripts, database cleaning up, etc. |
25 | | -All scripts in this repository are under [BSD 3-clause license](http://www.opensource.org/licenses/BSD-3-Clause) license, unless specified otherwise. |
26 | | - |
27 | | -Feel free to fork this repository and make your desired changes. |
28 | | - |
29 | | -Please see the [Developer's Certificate of Origin](https://github.com/norv/tools/blob/master/DCO.txt) in the repository: |
30 | | -by signing off your contributions, you acknowledge that you can and do license your submissions under the license of the software. |
31 | | - |
32 | | -## How to contribute: |
| 21 | +### How to contribute: |
33 | 22 | * fork the repository. If you are not used to Github, please check out [fork a repository](http://help.github.com/fork-a-repo). |
34 | 23 | * branch your repository, to commit the desired changes. |
35 | 24 | * sign-off your commits, to acknowledge your submission under the license of the project. |
36 | | - * an easy way to do so, is to define an alias for the git commit command, which includes `-s` switch (reference: [How to create Git aliases](http://githacks.com/post/1168909216/how-to-create-git-aliases)) |
| 25 | + * an easy way to do so, is to define an alias for the git commit command, which includes `-s` switch (reference: [How to create Git aliases](http://githacks.com/post/1168909216/how-to-create-git-aliases)) |
37 | 26 | * send a pull request to us. |
0 commit comments