more/webtrees/README.md

5 …e.webtrees.net/widgets/webtrees/-/webtrees-22/svg-badge.svg)](https://weblate.iet.open.ac.uk/proje…
6 … Code Quality](https://scrutinizer-ci.com/g/fisharebest/webtrees/badges/quality-score.png?b=main)]…
9 # webtrees - online collaborative genealogy
14 * [Coding styles and standards](#coding-styles-and-standards)
16 * [System requirements](#system-requirements)
17 * [Internet browser compatibility](#browser-compatibility)
20 * [Building and developing](#building-and-developing)
21 * [Gedcom (family tree) files](#gedcom-family-tree-files)
24 * [Restore from Backup](#restore-from-backup)
46 webtrees follows the [PHP Standards Recommendations](https://www.php-fig.org/psr).
48 * [PSR-1](https://www.php-fig.org/psr/psr-1) - Basic Coding Standard
49 * [PSR-2](https://www.php-fig.org/psr/psr-2) - Coding Style Guide
50 * [PSR-4](https://www.php-fig.org/psr/psr-4) - Autoloading Standard
51 * [PSR-6](https://www.php-fig.org/psr/psr-6) - Cache
52 * [PSR-7](https://www.php-fig.org/psr/psr-7) - HTTP Message Interface
53 * [PSR-11](https://www.php-fig.org/psr/psr-11) - Container Interface
54 * [PSR-12](https://www.php-fig.org/psr/psr-12) - Extended Coding Style Guide
55 * [PSR-15](https://www.php-fig.org/psr/psr-15) - HTTP Handlers
56 * [PSR-17](https://www.php-fig.org/psr/psr-17) - HTTP Factories
58 We do not currently use [PSR-3 (logging)](https://www.php-fig.org/psr/psr-3) - but we plan to do so…
69 third-party tools, design techniques and open standards.
95 * A database. MySQL is recommended, although PostgreSQL, SQL-Server and SQLite can be used. Some fe…
98 * PHP 7.1 - 7.4. Servers with PHP 5.3 - 7.0 can use **webtrees** 1.7.
108   Chrome, and Safari.  Support for other browsers and older versions is on a case-by-case basis.
112 1. Download the .ZIP file for latest stable version from [github.com](https://github.com/fisharebes…
120 If you have a GEDCOM file, you can import it into the tree. If not, just start
124 privacy settings first. Don't worry too much about all the other options - the
150    file **data/offline.txt**. While this file exists, visitors will see a
151    “site unavailable - come back later” message.
152   4. Unzip the .ZIP file, and upload the files to your web server, overwriting the existing files.
153   5. Delete the file **data/offline.txt**.
175 You will need [npm](https://www.npmjs.com/get-npm) to install the Javascript dependencies.
181 You will need to re-run the second of these any time you modify the file `webtrees.js`.
185 When you import a family tree (GEDCOM) file in **webtrees** the
186 data from the file is transferred to the database tables. The file itself
189 will not change this file
192 necessary to delete your GEDCOM file or database from **webtrees** and start
195 * Go to ``Control panel`` -> ``Manage family trees`` On the line relating to this particular family…
196   file (or a new one) select IMPORT.
198   in **webtrees**, and have edited your data off-line using software that
202   During this process, **webtrees** copies your entire family tree (GEDCOM file)
203   to a 'chunk' table within your database. Depending on the coding of your file,
204   its file size and the capabilities of your server and the supporting software,
217 config.ini.php file, and various temporary files. If you are concerned there
218 may be a risk there is a very simple test you can do: try to fetch the file
219 config.ini.php by typing **``url_to_your_server/data/config.ini.php``** in your web
226     You don't have permission to access /data/config.ini.php on this server.
231 In the unlikely event you do fetch the file (you will just see a semicolon),
250 and place your GEDCOM (family tree) file there.
252 Then change the **Data folder** setting on the ``Control panel`` ->
253 ``Website`` -> ``Website preferences`` page from the default **data/** to the new
258 * [path to webtrees]/data - just needs to contain config.ini.php
259 * /home/username/private/data - contains everything else
272 …`mysqldump --host=[localhost] -u [username] -p[password] --databases [databasename] > dump_file.sq…
274     Note that '*-p[password]*' goes together with no space in between.
289     `mysql -u [username] -p[password] [database_name] < [dump_file.sql]`
291 4. Confirm the file *data/config.ini.php* contains to correct information to connect to the databas…