2
require_once("docutil.php");
3
page_head("Web site overview");
5
<h2>Customizing the default web site</h2>
7
When you create a BOINC project using
8
<a href=make_project.php>make_project</a>,
9
a web site is created for you.
10
This consists of a front page (html/user/index.php),
11
which links to pages where users can
12
log in, edit preferences, create profiles, and so on.
14
Before your project goes public,
15
you'll want to change this web site by
16
adding content specific to your project,
17
and by giving the web site a graphical identity specific to your project.
18
Make sure you do a good job;
19
your web site has a large impact on your project's ability to
20
<a href=recruit.php>recruit and retain participants</a>.
24
Some of this customization can be done by editing
25
the main page (index.php) and the stylesheet (white.css).
26
Other aspects are changed using a configuration file, described below.
28
<h2>Web configuration file</h2>
30
The file 'html/project/project.inc' serves as a
31
configuration file for your web site.
32
It exists in a separate directory (html/project) so that
33
you can put this directory under CVS
34
and put all project-specific web files there
35
(create symbolic links from html/inc and html/user).
37
project.inc is generated by <a href=make_project.php>make_project</a>
39
It includes constants:
42
list_item("PROJECT", "The name of your project");
43
list_item("MASTER_URL", "Your project's master URL");
44
list_item("URL_BASE", "Base URL for web pages (usually same as master URL)");
45
list_item("STYLESHEET", "Name of stylesheet file");
46
list_item("COPYRIGHT_HOLDER", "Name of copyright holder");
47
list_item("SYS_ADMIN_EMAIL", "Users are directed here if they
48
have complaints about message-board moderation.
49
Also, messages about user-of-the-day running low are sent here.
51
list_item("FORUM_MODERATION_EMAIL_USER_ID",
52
"Moderation-related emails (such as user complaints) are sent here.
54
list_item("INVITE_CODES", "regular expression used for
55
<a href=account_control.php>controlling account creation</a>.
57
list_item("EMAIL_FROM", "'from' address for emails");
58
list_item("EMAIL_FROM_NAME", "'from' name for emails");
65
list_item("project_banner($title)", "prints page header");
66
list_item("project_banner()", "prints page footer");
67
list_item("show_profile_heading1(), show_profile_heading2()",
68
"text on user profile page");
69
list_item("show_profile_question1(), show_profile_question2()",
70
"text on user profile page");
71
list_item("project_workunit()",
72
"prints project-specific text on workunit page"
74
list_item("project_user_summary()",
75
"prints project-specific text on user page"
77
list_item("project_user_page_private()",
78
"prints project-specific text on private user page"
85
list_item("USE_PHPMAILER", "Set to true if you use
86
<a href=http://phpmailer.sourceforge.net/>PHPMailer</a>.
87
In this case you must download PHPMailer and put it
88
(i.e. the directory 'phpmailer') in your html/inc directory.
90
list_item("PHPMAILER_HOST",
91
"The Host argument to PHPMailer; typically a semicolon-separated list
94
list_item("PHPMAIL_MAILER",
95
"The Mailer argument to PHPMailer; typically 'sendmail', 'mail', or 'smtp'.