Handleiding door Yossi Beck.

Deze handleiding moet nog vertaald worden naar Nederlands...

Installation of HuMo-gen (PHP) on your own (local) PC with XAMPP-lite

(Though HuMo-gen is meant primarily for publishing your genealogy data on the internet, it is advisable to make an installation on your local PC as well for testing new versions of HuMo-gen or to try out alterations you may wish to make in the program)

LET OP: HuMo-gen (PHP) is gemaakt om op een webserver te installeren. Deze methode is alleen maar bedoeld om HuMo-gen (PHP) te testen!

In order to be able to watch and test the database on your own PC, first several programs have to be installed:
- A webserver (for example Apache)
- A MySQL server (the database server)
- A Php program.

For most users, installing and setting up those programs would be quite a tedious job.
Fortunately there are simple free programs that simulate a tripple setup of Apache, PHP and mySQL and allow you to run HuMo-gen (and other server-side programs) as if they were run from a webserver.
We suggest you use XAMPP, which is one of the more reknowned free programs that offer a simple one-in-all solutions for server, PHP and mySQL simulation.
Xampp can be downloaded here
We suggest you download the XAMPP Lite version which is all you need to run HuMo-gen on your computer.

The following instructions assume that you install XAMPP Lite on a Windows platform.

  1. Go to the download link mentioned above. Click Xampp Lite. [ screenshot ]
    On the next page download the EXE version. [ screenshot ]
    Save it anywhere on your disk.
  2. Go to the place where you saved the downloaded file and double-click it.
  3. On the installation screen leave the default setting (C:\). [ screenshot ]
    Press "Install". An xampplite folder will be created in C:\.  Wait for all the files to be extracted.
  4. When all files have been extracted a black "DOS-type" screen will pop up. Don't worry, after installation is finished you won't have to deal with screens like that...     In the mean time answer the few simple questions with "y" or "n".
    My suggestions: 
    Should I add shortcuts to the startmenu/desktop: "y" (default - It is useful to have an XAMPP icon on your desktop for easy opening of the control panel.)
    Should I proceed: "y" (default - if you don't choose this we won't get anywhere, will we?)
    Should I make portable Xampp: "n" (default - we don't need that)
  5. Press continue twice (ignore the remarks about time settings in .ini files. Who cares?).
    The next screen gives you 5 options. If you installed in C:\xampplite as we suggested, you are now ready to start the XAMPP control panel - so choose option 1 and hit "Enter". We're back in the window age and a small window with the XAMPP control panel opens up. You can now safely close your "DOS" window - it doesn't close automatically and it ain't pretty anyway...
  6. In the XAMPP control panel click in the svc box next to "Apache". Click OK on the pop-up screen. [ screenshot ] If Vista asks for authorization - OK that too. Now click the "start" button nex to "Apache". [ screenshot ] After a few seconds, if all went well, the start button should have changed to a "stop" button and "running" should appear in green next to it.
  7. Repeat the same for mySQL. Should be running too now.
  8. Now hit the "Admin" button next to "Apache". Choose "English". On the webpage that opens up - choose "status" on the menu to the left. [ screenshot ] If all is well all functions are activated except for IPv6.
  9. Return to the XAMPP control panel. Hit the "Admin" button next to "mySQL". This brings you to the phpMyAdmin webpage. Here you can make up your mySQL database. In the "create new database" box enter a name of your liking. I strongly suggest you call your new database "humo-php", which is the default database name already included in HuMo-gen, so you won't have to change that later. [ screenshot ] If you choose any other name, we will let you know where to adjust that further on. Hit the "Create" button. Finished. You can close the page or just leave it.
  10. We're done with XAMPP now. All that's left is to copy your unzippped HuMo-gen folder into the C:\xampplite\htdocs folder. [ screenshot ]
  11. Now we get to the HuMo-gen(PHP) set-up. Open the humo-gen folder that you just copied into the xampplite\htdocs folder, go to the "include" folder and find the file:  db_login.php.  Open it for editing. Change the default value for DATABASE_PASSWORD from "usbw" into:   ""  (in other words - an empty string). If you created the mySQL database with the name "humo-php" as I suggested before, you're done. If you insisted giving it any other name, let's say "daisy", change DATABASE_NAME from "humo-php" into "daisy". Save the file db_login.php.
  12. You can know acces the HuMo-gen(PHP) Admin menu by entering the following URL in your browser: http://localhost/humo-gen/admin. The status screen will have a lot of red warnings. [ screenshot ] Don't worry - most of them are only important when installing on the real web. We're on your own computer so we can relax. The only red box you have to deal with is the first red box (the second overall box from the top): Click the "Install" button in the red box to create the HuMo-gen tables in the mySQL database. On the following page click install again (just to make sure). Now hit "Yes" to make really-really sure...
  13. Choose "Family Trees" from the menu to the left. You will be prompted for username and password. The default username is "beheer" (Dutch for admin) and the password "humogen". Fill these in, hit "Enter" and we're back at the Admin status menu, with one red box less. Only one more step to go.
  14. On the lower red box press the "import Gedcom" button. On the next screen hit "Browse" and find the Gedcom file you want to use for your site (you can add more later on if needed). Choose it. You will be told the file was "uploaded" successfully. Hit "step 2" - the tables are filled in. Hit "Step 3" - The Gedcom file will be read in with a progress bar. Hit "Step 4". You're ready. You can either use the "index.php" link that's waiting for you there, or enter the full URL localhost/humo-gen in your browser. You will see the default front page of your new website as it would look on the web. Now you can go back to the admin page localhost/humo-gen/admin to enter general details for your site under "Settings", import additional Gedcoms under "Family Tree" or enter descriptions, links etc. for each tree in 4 languages.
  15. To update a gedcom file, you only have to do this:
    - Open the administration screen in your browser: http://localhost/humo-gen/admin
    - Click on "Family Trees"
    - Select "Family Tree Data next to the tree you want to update.
    - Hit "Import Gedcom" and choose your updated Gedcom file.

REMEMBER: Each time you want to run HuMo-gen on your local PC you have to first open the XAMPP control panel and start Apache and mySQL! Then you can go to localhost/humo-gen or localhost/humo-gen/admin as explained above.

HuMo-gen