FIXES FOR 90% OF ISSUES

[ejv2]

As it turns out, the amount of threads taken up by different classes of issues follows a Pareto Distribution, in which 90% of issues are caused by around 10% of possible problems. This thread archives the solutions to these 90% of issues by containing 10% of the technical support in the documentation, summarized for convenience. To suggest more, please open a documentation request issue mentioning the "90% troubleshooter".

Remember! If your issue isn't in here, that doesn't mean it has no solution. Please also read the documentation, in particular the FAQ.

Thanks and happy scambaiting!

[ejv2]

PHP Include errors (require_once, failed to open stream, Hooks.php, Requests.php, etc.)

You most likely forgot to pull submodules. Run the following in a terminal:

git submodule update --init --recursive

---

Documentation Reference: README
Exemplary Issues: #57, #67, #45,

[ejv2]

Missing Configuration Files and Open File Errors

You most likely forgot to run the install script. Navigate to the root of the project (not the webserver root, the git root into which you cloned the project) and run the following:

python ./scripts/Install.py

Wait until the script completes, following any instructions on screen.

---

Documentation Reference: Preparing a Developer Install
Exemplary Issues: #5, #43

[ejv2]

Blank Pages with PHP Unknown Function/Class Errors (Class 'NumberFormatter' not found, 'mysqli_open' not found)

You most likely have not enabled the minimum required extensions in PHP, or have enabled them without installing. DSJAS requires the following PHP extensions to be installed and enabled:

1. mysqli
2. intl
3. sodium - no longer required as of v0.1.5
4. zip
5. iconv
6. exif

To enable them, find your PHP config file and uncomment the lines which read ";extension=" by removing the semi colon at the beginning of the line. You must then restart your web server.

---

Documentation Reference: Install Getting Started
Exemplary Issues: #38, #32

[ejv2]

Statistics System Errors on Unrelated Pages

These errors are mostly benign and do not affect the function of the site. However, if a page is crashing with this error each time, please open an issue and I will fix the problem.

---

Documentation Reference: Statistics Documentation
Exemplary Issues: #66

[ejv2]

CSRF Errors

These occur when more than one browser is using the site at a time when logged in to a single account. You can fix this in the short-term by simply pressing the back button, refreshing the page and repeating whatever action you were attempting to perform. In the long-term, try creating a separate account for each browser which you wish to use (especially if one will be used in a VM, which tends to trigger this problem most commonly).

---

Documentation Reference: Access Management
Exemplary Issues: None! (I'm being preemptive)