Changes between Version 30 and Version 31 of WebConfig


Ignore:
Timestamp:
Mar 16, 2015, 9:39:52 PM (9 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WebConfig

    v30 v31  
     1[[PageOutline]]
    12= Web site customization =
    23
     
    2930Edit this file to customize the constants and functions it contains.
    3031
    31 Constants:
     32=== Constants ===
    3233
    3334 '''PROJECT'''::
    34         The name of your project
     35    The name of your project
    3536 '''URL_BASE'''::
    36         Base URL for web pages (usually same as master_url defined in config.xml).
     37    Base URL for web pages (usually same as master_url defined in config.xml).
    3738 '''SECURE_URL_BASE'''::
    3839        (optional) URL prefix for forms with passwords.  If your web server supports HTTPS, set this accordingly.
    3940 '''STYLESHEET'''::
    40         Name of stylesheet file (such as `white.css`)
     41    Name of stylesheet file (such as `white.css`)
    4142 '''STYLESHEET2'''::
    4243        Name of an optional project supplied stylesheet.
     
    5253        url path to user profiles, is appended to URL_BASE (default: user_profile/)
    5354 '''LANGUAGE_FILE'''::
    54         name of a text file that contains language names that are shown in a selection box to the user at his profile. File is expected in html/user. (default: languages.txt)
     55        name of a text file that contains language names that are shown in a selection box to the user at his profile.
     56    File is expected in html/user. (default: languages.txt)
    5557 '''COPYRIGHT_HOLDER'''::
    56         Name of copyright holder
     58   Name of copyright holder
    5759 '''SYS_ADMIN_EMAIL'''::
    58         Users are directed here if they have complaints about message-board moderation.
     60    Users are directed here if they have complaints about message-board moderation.
    5961 '''UOTD_ADMIN_EMAIL'''::
    6062        Messages about user-of-the-day running low are sent here.
     
    6264        Send email if # of UOTD candidates falls below this (default 7)
    6365 '''POST_REPORT_EMAILS'''::
    64         Moderation-related emails (such as user complaints) are sent here.
     66    Moderation-related emails (such as user complaints) are sent here.
    6567 '''INVITE_CODES'''::
    66         Regular expression used for [AccountControl controlling account creation].
     68    Regular expression used for [AccountControl controlling account creation].
    6769 '''EMAIL_FROM'''::
    68         'from' address for emails
     70    'from' address for emails
    6971 '''EMAIL_FROM_NAME'''::
    70         'from' name for emails
     72    'from' name for emails
    7173 '''COUNTRY_FLAGS'''::
    7274       If defined, show country flags in forums.  Steps:
     
    111113     An array of strings.  An account's email address may not end with any of these strings.
    112114
    113 Functions:
     115=== Functions ===
    114116
     117 '''donations_intro()'''::
     118    Displays customized donation information.
     119    Useful to describe what the project uses donations for, and project specific guides for donations.
     120    If function is not defined, standard donation information is displayed.html/user/donations.php.
    115121 '''project_banner()'''::
    116         Prints page header
     122    Prints page header
    117123 '''project_footer()'''::
    118         Prints page footer
     124    Prints page footer
     125 '''project_forum_post_rules()''':: return a string describing message board policies.
     126 '''project_rules_policies()'''::
     127    Displays customized project rules and policies.
     128    If return value is ''true'', standard rules and policies are appended.
     129    If function is not defined, default rules and policies are displayed.
     130 '''project_user_links($user)'''::
     131    Return project-specific text to be shown after user name.
     132 '''project_user_page_private()'''::
     133    Prints project-specific text on private user page
     134 '''project_user_summary()'''::
     135    Prints project-specific text on user page
     136 '''project_workunit($wu)'''::
     137    Prints project-specific text on workunit page
     138 '''server_status_project()'''::
     139    Prints project-specific info on server status page (server_status.php).
    119140 '''show_profile_heading1(), show_profile_heading2()'''::
    120         Text on user profile page
     141    Text on user profile page
    121142 '''show_profile_question1(), show_profile_question2()'''::
    122         Text on user profile page
    123  '''project_workunit($wu)'''::
    124         Prints project-specific text on workunit page
    125  '''project_user_links($user)'''::
    126         Return project-specific text to be shown after user name.
    127  '''project_user_summary()'''::
    128         Prints project-specific text on user page
    129  '''project_user_page_private()'''::
    130         Prints project-specific text on private user page
    131  '''donations_intro()'''::
    132     Displays customized donation information. Useful to describe what the project uses donations for, and project specific guides for donations. If function is not defined, standard donation information is displayed.html/user/donations.php.
    133  '''project_rules_policies()'''::
    134     Displays customized project rules and policies. If return value is ''true'', standard rules and policies are appended. If function is not defined, default rules and policies are displayed.
    135  '''project_forum_post_rules()''':: return a string describing message board policies.
     143    Text on user profile page
    136144
    137 To use [https://github.com/PHPMailer/PHPMailer PHPMailer] (the preferred way to send emails to participants), you must download PHPMailer and put it in PROJECT/html/inc/phpmailer (i.e. the files class.smtp.php and class.phpmailer.php should be in that directory). Than modify the following function:
     145To use [https://github.com/PHPMailer/PHPMailer PHPMailer] (the preferred way to send emails to participants),
     146you must download PHPMailer and put it in PROJECT/html/inc/phpmailer
     147(i.e. the files class.smtp.php and class.phpmailer.php should be in that directory).
     148Then modify the following function:
    138149
    139  '''make_php_mailer()''':: return a PHPMailer object with authentication information (see ServerIntro#PHPMailer), used when the above is set to true.
     150 '''make_php_mailer()''':: return a PHPMailer object with authentication information (see ServerIntro#PHPMailer),
     151used when the above is set to true.
    140152
    141 If you do not define '''make_php_mailer()''' then e-mail to participants can still be sent, but it will use PHP's simpler '''mail()''' function.
     153If you do not define '''make_php_mailer()''' then e-mail to participants can still be sent,
     154but it will use PHP's simpler '''mail()''' function.