forked from Kroc/NoNonsenseForum
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.txt
234 lines (183 loc) · 9.39 KB
/
INSTALL.txt
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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
NoNonsense Forum v25 © Copyright (CC-BY) Kroc Camen 2010-2013
========================================================================
Contents:
========================================================================
[0] Requirements
[1] Install
[1.1] Install from a download
[1.2] Install using GIT
[1.3] Installation (continued)
[1.4] Updating NoNonsense Forum
[1.5] Running without HTAccess
[2] Customising
[2.1] 'config.php'
[2.2] 'theme.config.php'
[2.3] Favicon, touch-icon and Metro tile
[2.4] Adding a forum introduction (about.html)
[2.5] Custom CSS
[3] Translations
[0] Requirements:
========================================================================
* PHP 5.2.3 or above
* Apache 2.1 or above, preferably with ".htaccess" files enabled
(though optional), or any other webserver, whereby NNF will
operate in "no-htaccess" mode
Browser support: (default 'greyscale' theme)
* IE6, 7, 8, 9, 10+
* Firefox 3+, Camino 2+
* Chrome Stable, Chrome Dev
* Safari 3+
* Opera 9+
* Lynx & other text browsers
* iOS 4.0+ (iOS 3 untested)
* Android (all versions AFAIK)
* Firefox Mobile
* Opera Mobile & Mini
* Amazon Kindle (e-ink) & Fire
* IE9/Mobile (untested)
Unsupported:
* Firefox 2 or earlier, Camino 1
* IE5.5 and below (including IE:Mac)
* IE7/Mobile (Windows Phone 7)
[1] Install:
========================================================================
NoNonsense Forum can run on its own domain / sub-domain (preferred),
or within a sub-folder (e.g. '/forum/').
[1.1] Install from download:
------------------------------------------------------------------------
If you downloaded NoNonsense Forum as a ZIP / archive file:
* Copy this folder and all files to the web-root of a sub-domain
(like 'forum.---.com'), virtual host or other dedicated
web-root for the forum, or as a sub-folder therein.
NOTE: On some platforms, the ".htaccess" file may be invisible.
Please search the Internet for instructions on how to show
hidden files on your operating system if you cannot see the
".htaccess" file. It must be included with the other files for
NoNonsense Forum to work
[1.2] Install using GIT:
------------------------------------------------------------------------
The best way to install NoNonsense Forum (and keep it up to date) is to
use GIT <git-scm.org>. If you have GIT installed, then from the command
line / terminal enter:
git clone https://github.com/Kroc/NoNonsenseForum.git nononsense_forum
The code will be downloaded into a "nononsense_forum" folder in the
current directory.
Move this folder, or its contents to the desired location (as described
in "Install from download" above).
[1.3] Installation (continued):
------------------------------------------------------------------------
* Ensure the web-root / folder and all sub-folders (especially
"users") have write permission for PHP, the code will save new
threads in the same folder as the installation
* Visit the site in your browser. If all is well, you should have
an empty, but functional forum. If you're having problems you
can ask for help on the forums: <forum.camendesign.com>
NOTE: Please ensure ".htaccess" files are enabled on your web-server.
For example XAMPP does not execute ".htaccess" files by deafult
NOTE: If you run NoNonsense Forum in a sub-folder, any existing
".htaccess" rules from the web-root might 'leak' into the
folder and prevent the forum from working correctly.
It is recommended to use a sub-domain if you are not sure how
to manually edit ".htaccess" rules
Optional:
* Copy the 'config.default.php' file to a 'config.php' file and
customise the options within to your liking. Available options
are explained within 'config.default.php'.
You should leave the 'config.default.php' as-is to avoid
conflicts with future updates
[1.4] Updating NoNonsense Forum:
------------------------------------------------------------------------
Using GIT you can update NoNonsense Forum in-place without having to
re-download and install it. From the command line / terminal, enter:
(ensure that you are within the NoNonsense Forum installation folder)
git pull origin master
GIT will download and apply new features and fixes, without touching
your configuration or existing threads. This will not work if you have
modified any NoNonsense Forum files.
Alternatively, download the latest version and unzip the contents.
Copy everything within (ensuring you include the hidden ".htaccess"
file) and paste these into your existing installation; your personal
data will be left untouched, only the NNF files will be replaced.
However, you should always back up your forum before upgrading or
doing any changes.
You should *always* check the HISTORY.txt file or change log before
you update in case you are required to alter your configuration or be
aware of the impact of some new feature.
<github.com/Kroc/NoNonsenseForum/commits/master>
[1.5] Running without HTAccess:
------------------------------------------------------------------------
NoNonsense Forum will automatically detect if the ".htaccess" file is
missing or disabled and automatically switch to running without.
HTAccess is used to provide "pretty" URLs, but also secure the "users"
folder that contains the passwords, therefore in order to use NNF
without HTAccess, you must relocate the "users" folder via the
`FORUM_USERS` config option.
You will automatically be provided with instructions on how to do this
when NNF runs without HTAccess and the "users" folder is in its default,
insecure location.
[2] Customising:
========================================================================
[2.1] 'config.php':
------------------------------------------------------------------------
The 'config.default.php' file contains default settings for the forum,
make a copy of this file and name it 'config.php' -- DO NOT modify,
delete or rename 'config.default.php' as it is still required.
Modify your 'config.php' to your liking, the settings are explained
within.
[2.2] 'theme.config.php':
------------------------------------------------------------------------
The `FORUM_THEME` option in 'config.php' (default: "greyscale"), refers
to the name of the theme in the 'themes' folder. Inside the theme is a
'theme.config.default.php' file; make a copy of this file and rename to
'theme.config.php'.
Modify your 'theme.config.php' to your liking, the settings are
explained within.
DO NOT modify, delete or rename 'theme.config.default.php' as it is
still required.
[2.3] Favicon, touch-icon and Metro tile
------------------------------------------------------------------------
The site will use '/favicon.default.ico' as the favicon and
'/apple-touch-icon.deafult.png' for iOS home-screen icons by default,
just provide your own 'favicon.ico' and 'apple-touch-icon.png' files
to override. Each theme will have examples you can use in the theme
folder, just copy those to webroot to use.
Windows 8's Start Screen supports a custom icon when you pin a site to
the Start Screen. '/metro-tile.default.png' is used by default, but you
can override by providing your own 'metro-tile.png' file.
Your image must be 144x144px, must have a transparent background,
and the logo should fill the entire space, since Windows 8 already has
padding around the image.
NOTE: due to a bug in Windows 8, the 'metro-tile.png' file *must* be
a 32-bit PNG, and not 8-bit indexed (256-colour).
You can change the colour of the Metro tile by changing the
`METRO_COLOUR` setting in your theme config.
[2.4] Adding a forum introduction ('about.html'):
------------------------------------------------------------------------
You can add a custom message to the top of the forum index / sub-forum
index pages by creating an 'about.html' file in the folder and
populating it with HTML code.
This feature is primarily designed for you to add a description at the
top of each forum to tell visitors what the forum is used for, rules
etc., but since any HTML can be used you can add whatever you want --
social buttons, links, images and so forth.
If you are using translations, then you can also provide translations
of 'about.html' to match by creating 'about_xx.html' files, where 'xx'
is the language code of the translation; see section 3 for information
about using and providing theme translations.
[2.5] Custom CSS:
------------------------------------------------------------------------
Within the theme folder (that is where 'theme.css' is for the chosen
theme) create a 'custom.css' file and it will be automatically included.
[3] Translations:
========================================================================
NoNonsense Froum themes can provide user-selectable translations.
Translation files are stored as 'lang.xx.php' files in the theme's
folder (where 'xx' is the language code). Refer to 'lang.example.php'
in the 'greyscale' theme folder for full instructions on creating and
enabling theme translations.
Once a translation is provided and enabled, visitors to the site can
select their preferred language, and if their browser specifies their
language and that translation is available, it will be selected
automatically for them.
The user's choice of language is persisted with a cookie.
A privacy policy is included to explain this.