aboutsummaryrefslogtreecommitdiff
path: root/h-source/README.txt
blob: 1c8d8216ae78349d9ed6a0e2ef1212c7e17187d9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
== Introduction ==

h-source is a web software that can be used to build a community of people that want to share their hardware information. It is based on the EasyGiant PHP framework (www.easygiant.org) and can be considered an EasyGiant application


== Installation and configuration ==

In order to use h-source you have to install a web server that supports the URL rewrite feature (such as the Apache server with the mod_rewrite module installed), PHP 5.2 or newer and Mysql 5 or newer.


Extract the tarball inside a folder of your filesystem.

You have to create the MySQL database used by h-source. The tables of the database that have to be created are written inside the file tables.sql. A way to carry out this operation is the following:

Open a terminal and type:

	mysql -u <username> -p
	
where <username> is the database user. Write the password and type the following command:

	create database <db>;
	
where <db> is the database name you want to use. Close Mysql by typing the following command:

	exit
	
Now you have to move inside the folder that contains the tables.sql file and type the following command:

	mysql -u username -ppassword <db> < tables.sql
	
where username and password have to be changed with the real username and password. <db> is the name of the database just created.

Now you have created the database named <db>


Open the Config/Config.php file

You have to set the following constants:

	DB: name of the database (the database just created)
	USER: database user
	PWD: database password
	HOST: name of the mysql server (usually localhost)

	DOMAIN_NAME: the domain name of the website (use localhost or create a virtual host in your web server)

Now you have to copy the extracted h-source files inside the DocumentRoot of your server. You can choose to leave all the files inside the DocumentRoot or not, see the explanations in this page (http://www.easygiant.org/learn/index/6).

You have now to assure that the allowOverride directive is active in the configuration file of your Apache server. You have to activate the allowOverride directive for the folder inside which you have saved the h-source files (and the index.php file). If you have not activated the allowOverride directive, then your URL won't be interpreted by the mod_rewrite module (you won't be able to use h-source). In a GNU/Linux system the apache configuration file is usually saved at /etc/apache2/apache2.conf.

Direct your browser to the following URL:

	http://DOMAIN_NAME/
	
where DOMAIN_NAME is the domain name you have previously set (perhaps localhost). You should see the home page of the h-source software.



== Account issues ==

If you want that the system can send e-mails you have to specify the name of the SMTP server that has to be used. Open the file Application/Include/params.php and set the following static attributes of the Website class:

	$mailServer = "";  //set the mail server (only useful if $useSMTP = true)
	
	$generalMail = "";  //set the username of your mail account (always needed)
	
	$mailPassword = "";  //set the password of your mail account (only useful if $useSMTP = true)

	$fromEmail = "noreply@h-node.org"; //this is the "from address e-mail" used inside the mails sent by h-source (example: confirmation requesta e-mail, change password e-mail, ...)

	$useSMTP = true;  //if you want to use a SMTP account. It can be true or false. Set $useSMTP to false if you want that the software rely on the mail() PHP function
		
You can also set these constants:

	$generalName = "";  //the string that you want to use inside the <title> tag of your website
	
	$projectName = "";  //the name of your project 


== Change the configuration of some parts of the template (right column, top notices, top menu, ...) ==

Modify the file config.xml inside the ROOT folder of your h-source installation.

If you want to change the position of the config.xml file change the following static attribute of the Website class inside the 
Application/Include/params.php file:
	
	static public $xmlConfigFileFolder = ROOT; //the constant ROOT contains the path to the root folder of your installaton of h-source

== Change the homepage ==


Modify the PHP files inside the folder Application/Views/Home


== Change the hardware ==


Modify the PHP file Application/Include/hardware.php


== Change the allowed distributions ==


Modify the PHP file Application/Include/distributions.php


== Change the allowed languages ==


Modify the PHP file Application/Include/languages.php



== Learn the EasyGiant PHP framework ==

Since h-source is an application of the EasyGiant PHP framework you can use the EasyGiant features in order to modify the h-source source code. Visit www.easygiant.org


// h-source, a web software to build a community of people that want to share their hardware information.
// Copyright (C) 2010  Antonio Gallo (h-source-copyright.txt)
//
// This file is part of h-source
//
// h-source is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// 
// h-source is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
// 
// You should have received a copy of the GNU General Public License
// along with h-source.  If not, see <http://www.gnu.org/licenses/>.