-
Notifications
You must be signed in to change notification settings - Fork 19
/
config.html
2339 lines (2200 loc) · 131 KB
/
config.html
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
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Geeklog Documentation - Configuration</title>
<link rel="stylesheet" type="text/css" href="../docstyle.css" title="Dev Stylesheet" />
</head>
<body>
<p><a href="https://www.geeklog.net/" style="background:transparent"><img src="../images/newlogo.gif" alt="Geeklog" width="243" height="90" /></a></p>
<div class="menu"><a href="index.html">Geeklog Documentation</a> - Configuration</div>
<h1>Geeklog Configuration</h1>
<h2>Configuration files</h2>
<p>Previous versions of Geeklog used one huge file called <span class="tt">config.php</span>
that held all the core configuration options. As of Geeklog 1.5.0, most of
the configuration options have been moved to the database and can now be
reached from the <strong>Configuration</strong> admin panel within Geeklog.</p>
<p>For technical reasons, some configuration options still have to be
stored in files. There are two such configuration files now:</p>
<ul>
<li><a href="#db-config.php">db-config.php</a></li>
<li><a href="#siteconfig.php">siteconfig.php</a></li>
</ul>
<p>These files are updated
when you install Geeklog and you will not normally have to edit them
manually.</p>
<h1>Configuration options</h1>
<p>Geeklog's configuration options are grouped like this:</p>
<ul>
<li><a href="#site">Site</a></li>
<li><a href="#stories">Articles and Trackback</a></li>
<li><a href="#theme">Theme</a></li>
<li><a href="#blocks">Blocks</a></li>
<li><a href="#users">Users and Submissions</a></li>
<li><a href="#images">Images</a></li>
<li><a href="#languages">Languages and Locale</a></li>
<li><a href="#misc">Miscellaneous</a></li>
<li><a href="#filemanager">File Manager</a></li>
</ul>
<h2><a name="site">Site</a></h2>
<h3><a name="site_site">Site: Site</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_site_url">site_url</a></td>
<td valign="top">http://www.example.com</td>
<td valign="top">Base URL for your site (no trailing slash)</td></tr>
<tr>
<td valign="top"><a name="desc_site_admin_url">site_admin_url</a></td>
<td valign="top">http://www.example.com/admin</td>
<td valign="top">Base URL of the admin area of your site (no trailing slash).
You won't have to change this normally, but some hosting services use a
predefined "admin" directory for other purposes. In this case, you can
rename Geeklog's <span class="tt">admin</span> directory and adjust the URL accordingly to
avoid conflicts.</td></tr>
<tr>
<td valign="top"><a name="desc_site_name">site_name</a></td>
<td valign="top">Geeklog Site</td>
<td valign="top">Name of your site</td></tr>
<tr>
<td valign="top"><a name="desc_site_slogan">site_slogan</a></td>
<td valign="top">Another Nifty Geeklog Site</td>
<td valign="top">Slogan for your site. This is added to the HTML title field.</td></tr>
<tr>
<td valign="top"><a name="desc_site_disabled_msg">site_disabled_msg</a></td>
<td valign="top">'Geeklog Site is down. Please come back soon.'</td>
<td valign="top">This contains the message to display when a Geeklog site is
disabled. If the text begins with "http:" then visitors are redirected to
that URL.<br />
<strong>Note:</strong> The option which actually disables the site can be found
in the <span class="tt">siteconfig.php</span> file.</td></tr>
<tr>
<td valign="top"><a name="desc_owner_name">owner_name</a></td>
<td valign="top"></td>
<td valign="top">The name of the owner of the site. This is used in the copyright notice if set, else the site name is used.</td></tr>
<tr>
<td valign="top"><a name="desc_copyrightyear">copyrightyear</a></td>
<td valign="top"><em>(disabled)</em></td>
<td valign="top">Set this to the year you want to appear in the copyright notice of your
site's footer. If not set, Geeklog will use the current year.</td></tr>
<tr>
<td valign="top"><a name="desc_url_rewrite">url_rewrite</a></td>
<td valign="top">false</td>
<td valign="top">Enable (true) or disable (false) URL rewriting.<br />
Also see the section on <a href="#url-rewrite">URL Rewriting</a> below.</td></tr>
<tr>
<td valign="top"><a name="desc_url_routing">url_routing</a></td>
<td valign="top">Disabled</td>
<td valign="top">Enable or disable URL routing. <strong>Caution: This feature takes effect only when URL Rewriting is enabled.</strong><br />
The setting 'Enabled (without "index.php")' requires additional settings for your web server to work properly.
See the section on <a href="#url-routing">URL Routing</a> below for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_cdn_hosted">cdn_hosted</a></td>
<td valign="top">false</td>
<td valign="top">Enable (true) or disable (false) Google CDN-hosted source for jQuery
and jQuery UI.</td></tr>
<tr>
<td valign="top"><a name="desc_meta_tags">meta_tags</a></td>
<td valign="top">disabled</td>
<td valign="top">Enabled - The meta tags for articles and topics will be displayed. If none are found, then the default will be used. The default will also be used for any page that doesn't have meta tags.<br />
Enabled (Default for Homepage only) - The same as Enabled except, the defaults are used only for the Homepage.<br />
Disabled - Meta tags are not used.</td></tr>
<tr>
<td valign="top"><a name="desc_meta_description">meta_description</a></td>
<td valign="top">'Geeklog, the open source content management system designed with security in mind.'</td>
<td valign="top">The default meta description for your site.</td></tr>
<tr>
<td valign="top"><a name="desc_meta_keywords">meta_keywords</a></td>
<td valign="top">'Geeklog, Blog, Content Management System, CMS, Open Source, Security'</td>
<td valign="top">The default meta keywords for your site.</td></tr>
</table>
<h3><a name="site_mail">Site: Mail</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_site_mail">site_mail</a></td>
<td valign="top">admin@example.com</td>
<td valign="top">E-mail address for all admin mail</td></tr>
<tr>
<td valign="top"><a name="desc_noreply_mail">noreply_mail</a></td>
<td valign="top">noreply@example.com</td>
<td valign="top">This is the sender's address of emails sent by the system when users register etc.
This should be either the same as $_CONF['site_mail'] or a bouncing address
to prevent spammers from getting your email address by registering on the site.
If this is NOT the same as above, there will be a message in sent messages
that replying to those emails is recommended.</td></tr>
<tr><td valign="top"><a name="desc_mail_settings_backend">mail_settings_backend</a></td>
<td valign="top">mail</td>
<td valign="top">Used to select how to send email. Can be one of 'smtp', 'smtps',
'sendmail', or 'mail'. The smtps protocol requires the PHP extension OpenSSL to work.</td></tr>
<tr><td valign="top"><a name="desc_mail_settings_sendmail_path">mail_settings_sendmail_path</a></td>
<td valign="top"><span class="tt">/usr/bin/sendmail</span></td>
<td valign="top">If you chose 'sendmail' for the backend setting, this
specifies the complete path to the sendmail binary.</td></tr>
<tr><td valign="top"><a name="desc_mail_settings_sendmail_args">mail_settings_sendmail_args</a></td>
<td valign="top"><span class="tt">''</span> <em>(empty)</em></td>
<td valign="top">If you chose 'sendmail' for the backend setting, this
variable can be used to pass additional parameters to the sendmail
binary.</td></tr>
<tr><td valign="top"><a name="desc_mail_settings_host">mail_settings_host</a></td>
<td valign="top">smtp.example.com</td>
<td valign="top">If you chose 'smtp' or 'smtps' for the backend setting, this is the
SMTP server to use.</td></tr>
<tr><td valign="top"><a name="desc_mail_settings_port">mail_settings_port</a></td>
<td valign="top">25</td>
<td valign="top">If you chose 'smtp' (port 25) or 'smtps' (port 587) for the backend setting, this is the
port number to talk to on the SMTP server.</td></tr>
<tr><td valign="top"><a name="desc_mail_settings_auth">mail_settings_auth</a></td>
<td valign="top">0</td>
<td valign="top">If you chose 'smtp' or 'smtps' for the backend setting, set this to
<code>1</code> if your SMTP server requires authorization, and
<code>0</code> (or leave the field empty) if it doesn't.</td></tr>
<tr><td valign="top"><a name="desc_mail_settings_username">smtp-username</a></td>
<td valign="top">smtp-username</td>
<td valign="top">If you chose 'smtp' or 'smtps' for the backend setting, this is the
name of your SMTP account.</td></tr>
<tr><td valign="top"><a name="desc_mail_settings_password">smtp-password</a></td>
<td valign="top">smtp-password</td>
<td valign="top">If you chose 'smtp' or 'smtps' for the backend setting, this is the
password for your SMTP account.</td></tr>
<tr><td valign="top"><a name="desc_mail_cc_enabled">mail_cc_enabled</a></td>
<td valign="top">True</td>
<td valign="top">Whether to allow users to send a copy of an email to themselves.</td></tr>
<tr><td valign="top"><a name="desc_mail_cc_default">mail_cc_default</a></td>
<td valign="top">False</td>
<td valign="top">Whether the carbon copy checkbox in the email form is ticked by default.</td></tr>
<tr><td valign="top"><a name="desc_mail_charset">mail_charset</a></td>
<td valign="top"><span class="tt">''</span> <em>(empty)</em></td>
<td valign="top">Character set to be used for encoding email messages. If you leave this empty, $_CONF['default_charset'] will be used instead.</td></tr>
</table>
<h3><a name="site_syndication">Site: Syndication</a></h3>
<p>Geeklog can export its headlines to a news feed in various formats (RSS, RDF, and Atom). This will let you share your news with other sites (Hint: Create a Portal block from Geeklog's Block menu to import news feeds from other sites).</p>
<p>Starting with Geeklog 1.3.9, feeds can be created and configured from
Geeklog's Admin menu ("Content Syndication"). The following settings will only
be used as the <em>default settings</em> for any new feeds that you create from
the admin panel.</p>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr><td valign="top"><a name="desc_backend">backend</a></td>
<td valign="top">1</td>
<td valign="top">Create a feed file for the articles in rdf_file (0=no, 1=yes)</td></tr>
<tr><td valign="top"><a name="desc_rdf_file">rdf_file</a></td>
<td valign="top">HTML path with "/backend/geeklog.rss" suffix</td>
<td valign="top">File system path for the feed file. This file allows you to share your site's headlines with others</td></tr>
<tr><td valign="top"><a name="desc_rdf_limit">rdf_limit</a></td>
<td valign="top">10</td>
<td valign="top">Limit the number of articles to export to the news feed. If the value for this setting is a number, the feed will hold this many articles. If the number is followed by a lower-case 'h' (e.g. 24h) it denotes the number of hours from which to chose the articles.</td></tr>
<tr><td valign="top"><a name="desc_rdf_storytext">rdf_storytext</a></td>
<td valign="top">0</td>
<td valign="top">If this value is 1, then the entire introtext of the articles will be included in the news feed. Any number greater than 1 limits the introtext to that many characters (e.g. a value of 80 would only include the first 80 characters from the introtext in the feed). If set to 0, the introtext is not included in the feed.</td></tr>
<tr><td valign="top"><a name="desc_rdf_language">rdf_language</a></td>
<td valign="top">en-gb</td>
<td valign="top">Value for the feed's language tag. Depending on your site's language and operating system, this may differ from the language setting in the locale (see above).<br /><strong>Example:</strong> The PHP locale setting for German is 'de_DE' while the correct language setting for a German RSS feed would be 'de-DE' (note the dash instead of the underscore).</td></tr>
<tr><td valign="top"><a name="desc_syndication_max_headlines">syndication_max_headlines</a></td>
<td valign="top">0</td>
<td valign="top">Upper limit for the max. number of headlines when <em>importing</em> a feed (into a portal block). The limit can also be set for each individual portal block in the block menu.<br />
When set to 0, all headlines are imported.</td></tr>
<tr><td valign="top"><a name="desc_comment_feeds_article_tag">comment_feeds_article_tag</a></td>
<td valign="top"><pre><p>[Original Article: <a href="%s">%s</a>%s%s]\n</pre></td>
<td valign="top">The string used to enter a tag about the article for the comment:<br /><br />
This must take three strings, in the order:<br />
<ol>
<li>Article URL - the url to the article</li>
<li>Article title - the title of the article</li>
<li>Article Author tag, the result of evaluating 'article_author_tag'</li>
<li>Comment author tag, the result of evaluating 'comment_author_tag'</li>
</ol><br />
This is generated with a sprintf command, so each item is indicated by a %s. If you want either of the last two to be blank, set article_author_tag and/or comment_author_tag to be empty strings.</td></tr>
<tr><td valign="top"><a name="desc_comment_feeds_article_tag_position">comment_feeds_article_tag_position</a></td>
<td valign="top">end</td>
<td valign="top">The position of the article_tag in the comment body. This indicates where the article tag, when formatted, should be inserted into the comment. This may be start, end or none.</td></tr>
<tr><td valign="top"><a name="desc_comment_feeds_article_author_tag">comment_feeds_article_author_tag</a></td>
<td valign="top"></td>
<td valign="top">A tag to link to the article author's profile, and display their name. This is included in the 'article_tag', if you don't want anything in the 'article_tag' then set it to the empty string. An example of an Article Author Tag would be: <pre> Written By: <a href="%s">%s</a></pre></td></tr>
<tr><td valign="top"><a name="desc_comment_feeds_comment_author_tag">comment_feeds_comment_author_tag</a></td>
<td valign="top"><pre>, Comment By: <a href="%s">%s</a></pre></td>
<td valign="top">A tag to link to the comment author's profile, and display their name. This is included in the 'article_tag', if you don't want anything in the 'article_tag' then set it to the empty string.</td></tr>
</table>
<h3><a name="site_paths">Site: Paths</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr><td valign="top"><a name="desc_path_html">path_html</a></td>
<td valign="top">/path/to/geeklog/public_html/</td>
<td valign="top">Path to your web tree directory for your site (trailing slash necessary). This directory holds all the web pages used by Geeklog.</td></tr>
<tr><td valign="top"><a name="desc_path_log">path_log</a></td>
<td valign="top">/path/to/geeklog/logs/</td>
<td valign="top">File system path for the log files</td></tr>
<tr><td valign="top"><a name="desc_path_language">path_language</a></td>
<td valign="top">/path/to/geeklog/language/</td>
<td valign="top">location of the Geeklog language files</td></tr>
<tr><td valign="top"><a name="desc_backup_path">backup_path</a></td>
<td valign="top">/path/to/geeklog/backups/</td>
<td valign="top">location where database backups are stored</td></tr>
<tr><td valign="top"><a name="desc_path_data">path_data</a></td>
<td valign="top">/path/to/geeklog/data/</td>
<td valign="top">File system path for the data directory, used e.g. for the user batch add feature</td></tr>
<tr><td valign="top"><a name="desc_path_images">path_images</a></td>
<td valign="top">/path/to/geeklog/public_html/images/</td>
<td valign="top">Path where Geeklog expects to find its images, including
user photos and images for articles.</td></tr>
<tr><td valign="top"><a name="desc_path_editors">path_editors</a></td>
<td valign="top">/path/to/geeklog/public_html/editors/</td>
<td valign="top">Path where all WYSIWYG editors reside.</td></tr>
</table>
<h3><a name="site_database">Site: Database</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr><td valign="top"><a name="desc_dbdump_filename_prefix">dbdump_filename_prefix</a></td>
<td valign="top">geeklog_db_backup</td>
<td valign="top">Prefix to use for the names of the backup files. Default file name will be "geeklog_db_backup_date_time.sql".</td></tr>
<tr><td valign="top"><a name="desc_dbdump_tables_only">dbdump_tables_only</a></td>
<td valign="top">0</td>
<td valign="top">Enable or disable dumping of table structure only, else dump both table and table data (1 = on,
0 = off).</td></tr>
<tr><td valign="top"><a name="desc_dbdump_gzip">dbdump_gzip</a></td>
<td valign="top">1</td>
<td valign="top">Compress database dump if gzip is available.</td></tr>
<tr><td valign="top"><a name="desc_dbdump_max_files">dbdump_max_files</a></td>
<td valign="top">10</td>
<td valign="top">Limit the number of backup files to keep. Use "0" to disable purging.</td></tr>
</table>
<h3><a name="site_search">Site: Search</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_search_style">search_style</a></td>
<td valign="top">'google'</td>
<td valign="top">Sets the style of the results page. Can be either 'google' or 'table'</td></tr>
<tr>
<td valign="top"><a name="desc_search_limits">search_limits</a></td>
<td valign="top">10,15,25,30</td>
<td valign="top">The result limits a user can select. Each value <strong>must</strong> be separated with a comma.</td></tr>
<tr>
<td valign="top"><a name="desc_num_search_results">num_search_results</a></td>
<td valign="top">30</td>
<td valign="top">The default number of results per page. Should be a value from 'search_limits' above.</td></tr>
<tr>
<td valign="top"><a name="desc_search_show_limit">search_show_limit</a></td>
<td valign="top">true</td>
<td valign="top">Shows (= true) or hides (= false) the page limits selection box.</td></tr>
<tr>
<td valign="top"><a name="desc_search_show_sort">search_show_sort</a></td>
<td valign="top">true</td>
<td valign="top">Shows (= true) or hides (= false) the 'Sort By' selection box. (When using the table style it will enable/disable column sorting)</td></tr>
<tr>
<td valign="top"><a name="desc_search_show_num">search_show_num</a></td>
<td valign="top">true</td>
<td valign="top">Shows (= true) or hides (= false) the result number.</td></tr>
<tr>
<td valign="top"><a name="desc_search_show_type">search_show_type</a></td>
<td valign="top">true</td>
<td valign="top">Shows (= true) or hides (= false) the plugin name the result came from.</td></tr>
<tr>
<td valign="top"><a name="desc_search_separator">search_separator</a></td>
<td valign="top"> &gt; (Space before and after character)</td>
<td valign="top">The character to display between result type sub groups.</td></tr>
<tr>
<td valign="top"><a name="desc_search_def_keytype">search_def_keytype</a></td>
<td valign="top">'phrase'</td>
<td valign="top">Default to one of these search methods:<ul>
<li>'all': results must contain all of the search terms.</li>
<li>'any': results may contain any of the search terms.</li>
<li>'phrase': search for the exact phrase as entered. (default)</li>
</ul></td></tr>
<tr>
<td valign="top"><a name="desc_search_def_sort">search_def_sort</a></td>
<td valign="top">'Hits (desc)'</td>
<td valign="top">The default sort order for the search results.</td></tr>
<tr>
<td valign="top"><a name="desc_search_use_topic">search_use_topic</a></td>
<td valign="top">false</td>
<td valign="top">If true the last topic the user visited will be set on the advanced search page and used automatically in the search block. If false, "All" topics will be set when the user visits the advance search page, and will be used when searching via the search block.</td></tr>
</table>
<h2><a name="stories">Articles and Trackback</a></h2>
<h3><a name="stories_story">Articles and Trackback: Article</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_maximagesperarticle">maximagesperarticle</a></td>
<td valign="top">5</td>
<td valign="top">max. number of images you can have in a article</td></tr>
<tr>
<td valign="top"><a name="desc_limitnews">limitnews</a></td>
<td valign="top">10</td>
<td valign="top">Number of articles to limit the index page to, this same number will appear in the older stuff block</td></tr>
<tr>
<td valign="top"><a name="desc_minnews">minnews</a></td>
<td valign="top">1</td>
<td valign="top">Minimum numbers of articles than can appear on a topic page</td></tr>
<tr>
<td valign="top"><a name="desc_contributedbyline">contributedbyline</a></td>
<td valign="top">1</td>
<td valign="top">Show author username to public, and enable search by username (0=no, 1=yes)</td></tr>
<tr>
<td valign="top"><a name="desc_hideviewscount">hideviewscount</a></td>
<td valign="top">0</td>
<td valign="top">Whether to show (= 0) or to hide (= 1) the number of views
a article has had.</td></tr>
<tr>
<td valign="top"><a name="desc_hideemailicon">hideemailicon</a></td>
<td valign="top">0</td>
<td valign="top">When set to 1, this will disable the ability to send a article by email. It
will also hide the email icon from articles and the "Email Article To a
Friend" from the Article Options block.</td></tr>
<tr>
<td valign="top"><a name="desc_hideprintericon">hideprintericon</a></td>
<td valign="top">0</td>
<td valign="top">When set to 1, this will disable display of a article in a "printer
friendly" format. It will also hide the printer icon from articles and
the "View Printable Version" from the Article Options
block.</td></tr>
<tr>
<td valign="top"><a name="desc_allow_page_breaks">allow_page_breaks</a></td>
<td valign="top">1</td>
<td valign="top">Allow usage of the <code>[page_break]</code> tag in articles (when set to 1), so that articles can spread over multiple pages.</td></tr>
<tr>
<td valign="top"><a name="desc_page_break_comments">page_break_comments</a></td>
<td valign="top">last</td>
<td valign="top">When the <code>[page_break]</code> tag is allowed in articles (see above), where should the article's comments be displayed: <code>'last'</code> = on the article's last page only, <code>'first'</code> = on the first page only, <code>'all'</code> = on every page.</td></tr>
<tr>
<td valign="top"><a name="desc_article_image_align">article_image_align</a></td>
<td valign="top">right</td>
<td valign="top">Which side of article the topic image should be shown (right or left)</td></tr>
<tr>
<td valign="top"><a name="desc_show_topic_icon">show_topic_icon</a></td>
<td valign="top">1</td>
<td valign="top">Default setting for new articles and article submissions: Whether to show the topic icon (1) or not (0).</td></tr>
<tr>
<td valign="top"><a name="desc_draft_flag">draft_flag</a></td>
<td valign="top">0</td>
<td valign="top">Default setting for new articles created by Story Admins: Whether the article's draft flag should be set (1) or not (0).</td></tr>
<tr>
<td valign="top"><a name="desc_frontpage">frontpage</a></td>
<td valign="top">0</td>
<td valign="top">Default setting for new articles and article submissions: Whether the article should appear on the site's frontpage (1) or only in its topic's page (0). Please note that for articles submitted to the archive topic, this setting will be ignored and the article will <em>not</em> appear on the frontpage.</td></tr>
<tr>
<td valign="top"><a name="desc_hide_no_news_msg">hide_no_news_msg</a></td>
<td valign="top">0</td>
<td valign="top">When set to 1, hide the "No News To Display" message on the index page (e.g. when viewing a topic without any articles in it)</td></tr>
<tr>
<td valign="top"><a name="desc_hide_main_page_navigation">hide_main_page_navigation</a></td>
<td valign="top">false</td>
<td valign="top">When set to frontpage, this option will hide the "Google paging"
navigation from index.php, i.e. from the site's frontpage. When set to frontpage_topics it will hide the navigation from the frontpage and all topic
pages. This may come in handy for more advanced layouts but will of course
prevent people from easily reaching older articles.</td></tr>
<tr>
<td valign="top"><a name="desc_onlyrootfeatures">onlyrootfeatures</a></td>
<td valign="top">0</td>
<td valign="top">This restricts the featuring of articles to root user(s). If you have several article admins who can create content that is not visible to other article admins,
and such a content is featured, another admin might think its ok to feature his own content. To prevent
that two admins unknowingly take features from each other away, only a user who can see all content (= root)
should be able to feature a article.</td></tr>
<tr>
<td valign="top"><a name="desc_aftersave_story">aftersave_story</a></td>
<td valign="top">'list'</td>
<td valign="top">Which page to go to after a article has been saved:
<ul>
<li>'item': display the article</li>
<li>'list': show admin's list of articles (default)</li>
<li>'home': display the site's homepage</li>
<li>'admin': go to the "Admin Home" page, i.e. Command & Control</li>
</ul>
<strong>Note:</strong> This option is ignored for article submissions. Editing
a article submission will always send you back to the submission queue (i.e.
"Admin Home" aka Command & Control).</td></tr>
<tr>
<td valign="top"><a name="desc_related_topics">related_topics</a></td>
<td valign="top">1</td>
<td valign="top">Set to display related topics on just article pages, article and topic pages, or no pages at all.</td></tr>
<tr>
<td valign="top"><a name="desc_related_topics_max">related_topics_max</a></td>
<td valign="top">6</td>
<td valign="top">Maximum numbers of topics to display for Related Topics. If 0 will display all related topics.</td></tr>
<tr>
<td valign="top"><a name="desc_whats_related">whats_related</a></td>
<td valign="top">1</td>
<td valign="top">Disable or Enable article What's Related block. You may also select to have no links (from the article) to be displayed in the list, or only no outbound links (pointing to other websites).</td></tr>
<tr>
<td valign="top"><a name="desc_whats_related_max">whats_related_max</a></td>
<td valign="top">0</td>
<td valign="top">Maximum numbers of items to display for the What's Related list on the article page. If 0 will display all related items found. A minimum of 2 items is required.</td></tr>
<tr>
<td valign="top"><a name="desc_whats_related_trim">whats_related_trim</a></td>
<td valign="top">26</td>
<td valign="top">Max. length of the title of items listed in the What's Related list. If 0 will not trim titles. If this option is changed this will update all related links in the database for articles.</td></tr>
<tr>
<td valign="top"><a name="desc_default_cache_time_article">default_cache_time_article</a></td>
<td valign="top">0</td>
<td valign="top">The default cache time for a article. Possible values:<br />
<ul>
<li>1 or more = Amount of seconds a article will be cached before it is regenerated and saved again to a new cache file.</li>
<li>0 = Not cached. Article is always regenerated.</li>
<li>-1 = Always cached and only regenerated when the article is updated and saved through the article editor.</li>
</ul></td></tr>
</table>
<h3><a name="stories_trackback">Articles and Trackback: Trackback</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_trackback_enabled">trackback_enabled</a></td>
<td valign="top">true</td>
<td valign="top">Enable (true) or disable (true) <a href="http://en.wikipedia.org/wiki/Trackback">trackback</a> comments. This applies to both sending and receiving trackback comments.</td></tr>
<tr>
<td valign="top"><a name="desc_trackback_code">trackback_code</a></td>
<td valign="top">0</td>
<td valign="top">Default value for new articles: Trackback enabled (0) or disabled (-1)</td></tr>
<tr>
<td valign="top"><a name="desc_trackbackspeedlimit">trackbackspeedlimit</a></td>
<td valign="top">300</td>
<td valign="top">Number of seconds between two trackbacks / pingbacks from the same IP address.</td></tr>
<tr>
<td valign="top"><a name="desc_check_trackback_link">check_trackback_link</a></td>
<td valign="top">2</td>
<td valign="top">This option can be used to check the validity of a trackback.
You can check if the URL in the trackback actually contains a link back to
your site (otherwise, it's probably spam). You can also check if the
trackback was sent from the proper IP address, i.e. the IP of the site in
the trackback URL (again, if they don't match, it's probably spam). Note
that you can <strong>add up the values</strong> below to do more than one
check (but using option 1 <em>and</em> 2 doesn't make sense and will be
treated as if you requested option 2).<br />
Options are: 0 = don't perform any checks, 1 = check only for your site's main URL (<code>$_CONF['site_url']</code>), 2 = check for the exact URL of the entry (e.g. an article) on your site, 4 = check IP address of the sender of the trackback against the site referred to in the trackback URL.<br />
<strong>Example:</strong> <code>$_CONF['check_trackback_link'] = 6; // check for the exact URL (2) and proper IP address (4)</code></td></tr>
<tr>
<td valign="top"><a name="desc_multiple_trackbacks">multiple_trackbacks</a></td>
<td valign="top">0</td>
<td valign="top">How to handle multiple trackbacks and pingbacks from the same source: 0 = keep only the first, reject any further trackbacks / pingbacks; 1 = overwrite, i.e. only keep the latest trackback / pingback; 2 = allow multiple trackbacks / pingbacks, i.e. list them all</td></tr>
</table>
<h3><a name="stories_pingback">Articles and Trackback: Pingback</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_pingback_enabled">pingback_enabled</a></td>
<td valign="top">true</td>
<td valign="top">Enable (true) or disable (true) <a href="http://en.wikipedia.org/wiki/Pingback">pingback</a> support. This applies to both sending and receiving pingbacks.</td></tr>
<tr>
<td valign="top"><a name="desc_pingback_excerpt">pingback_excerpt</a></td>
<td valign="top">true</td>
<td valign="top">Unlike Trackbacks, Pingback don't include an excerpt of the
text from the site linking to us. When this option is enabled, Geeklog will
try and create an excerpt by searching the backlink on the site that sent
the Pingback, extract a piece of the text near the link, and use that as
the excerpt for the Pingback.</td></tr>
<tr>
<td valign="top"><a name="desc_pingback_self">pingback_self</a></td>
<td valign="top">0</td>
<td valign="top">Pingbacks are sent out automatically to <em>all</em> the
URLs linked from a article - which includes articles on your own site that
you may have linked in the article. This option lets you specify how these
"self pingbacks" are to be handled: 0 = skip them, i.e. don't send pingbacks
to articles on your own site; 1 = allow them, but obey the speed limit;
2 = allow them and ignore the speed limit.<br />
If your article contains more than one link to other articles on your site,
then option 1 is probably of limited use, as it would only pingback the
first linked article and run into the speed limit for the others.</td></tr>
<tr>
<td valign="top"><a name="desc_ping_enabled">ping_enabled</a></td>
<td valign="top">true</td>
<td valign="top">Enable (true) or disable (true) the ability to ping weblog directory services like <a href="http://technorati.com/">Technorati</a>.</td></tr>
</table>
<h2><a name="theme">Theme</a></h2>
<h3><a name="theme_theme">Theme: Theme</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_theme">theme</a></td>
<td valign="top">Denim</td>
<td valign="top">Default theme to use on the site. Changing this setting will affect all new users, existing users (only if "Allow User Themes" is set to false) and anonymous users. When "Allow User Themes" is set to true, existing users will have to update the theme setting on the "My Account" user page and the Layout tab if they want to change themes.</td></tr>
<tr>
<td valign="top"><a name="desc_doctype">doctype</a></td>
<td valign="top">HTML 4.01 Strict</td>
<td valign="top"><a
href="http://en.wikipedia.org/wiki/Document_Type_Declaration">Document Type
Declaration</a> (aka DOCTYPE aka DTD) to use for all the themes on your
site, assuming they use the <span class="tt">{doctype}</span> variable instead of a
hard-coded DOCTYPE in their <span class="tt">header.thtml</span>.</td></tr>
<tr>
<td valign="top"><a name="desc_menu_elements">menu_elements</a></td>
<td valign="top"><code>array('contribute', 'search', 'stats', 'directory',
'plugins')</code></td>
<td valign="top">Specifies which entries are displayed in the site's menu bar
(if your theme uses the <code>{menu_elements}</code> variable to display
the menu bar). Can be any combination of <span class="tt">'home'</span>,
<span class="tt">'contribute'</span>, <span class="tt">'search'</span>, <span class="tt">'stats'</span>,
<span class="tt">'directory'</span>, <span class="tt">'login'</span>, <span class="tt">'prefs'</span>, <span class="tt">'plugins'</span>, and
<span class="tt">'custom'</span> where <span class="tt">'plugins'</span> is the same as the
<code>{plg_menu_elements}</code> variable, i.e. a list of the menu entries
provided by plugins, and <span class="tt">'custom'</span> displays the entries returned by
a custom function <code>CUSTOM_menuEntries</code> (see
<span class="tt">lib-custom.php</span> for details).</td></tr>
<tr>
<td valign="top"><a name="desc_path_themes">path_themes</a></td>
<td valign="top"><code>path/to/path_themes</code></td>
<td valign="top">Specifies the path to the parent directory (named "layout") of themes, which is directly under the path to public_html. Trailing slash is necessary.</td></tr>
<tr>
<td valign="top"><a name="desc_cache_templates">cache_templates</a></td>
<td valign="top">true</td>
<td valign="top">If set to <span class="tt">true</span>, all templates will be cached, which
should improve performance of the web site. In some cases, caching could
slow performance down. For example, if the disk access is slow on the web
server or if the web server is accessing Windows shared drives, setting this
option to FALSE may improve performance. Another reason to disable caching of template files is if you use
autotags in the themes template files that need to display updated information to the visitor (since the
autotags would only be run at the time when the cache file is created. Note: As stated this only affects
the theme template files. Caching of other items like Articles, Blocks, Staticpages, etc... have there own
config options for caching.</td></tr>
<tr>
<td valign="top"><a name="desc_cache_mobile">cache_mobile</a></td>
<td valign="top">true</td>
<td valign="top">If set to <span class="tt">true</span>, mobile devices (phones and tablets) will be cached
separately from computers. This includes the template files, blocks, articles and other plugins which may use
Geeklog's template cache system. You should only set this to false if you do not plan to display different information
depending on if a mobile device is detected being used by the user. Performance will be improved slightly if set to false since
less cached files will be created.</td></tr>
<tr>
<td valign="top"><a name="desc_cache_resource">cache_resource</a></td>
<td valign="top">true</td>
<td valign="top">If set to <span class="tt">true</span>, JavaScript files and CSS files will be combined, minified and cached.</td></tr>
</table>
<h3><a name="theme_advanced">Theme: Advanced Settings</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_show_right_blocks">show_right_blocks</a></td>
<td valign="top">false</td>
<td valign="top">If set to <span class="tt">true</span>, the right-side column of blocks
will be displayed on <em>all</em> pages (instead of only on the index
page).</td></tr>
<tr>
<td valign="top"><a name="desc_showfirstasfeatured">showfirstasfeatured</a></td>
<td valign="top">0</td>
<td valign="top">When set to 1, this will render the first article on <em>any</em> page
using the templates for a featured article, even if that article is not
featured. This will even be applied to the first article on page 2 of a
topic page, for example.</td></tr>
<tr>
<td valign="top"><a name="desc_template_comments">template_comments</a></td>
<td valign="top">false</td>
<td valign="top">Each template contains some internal comments
(surrounded with {# #} ) that are removed before the template is sent to the
browser. If this option is set to True, the {# and #} will become <!-- -->
HTML comments and will be included in the output to the browser. Also, at the
beginning and end of each template, its physical location on the
server, will be included in the output only if you are in the Root group and the <code>debug</code> property of the template class is set to the value other than 0. This feature is useful if you are
trying to determine which template controls a specific display item, or when
developing a new theme. If this is set to False, the comments are removed
prior to sending the output to the browser.</td></tr>
</table>
<h2><a name="blocks">Blocks</a></h2>
<h3><a name="blocks_admin">Blocks: Admin Block</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_sort_admin">sort_admin</a></td>
<td valign="top">false</td>
<td valign="top">If set to <span class="tt">true</span> will sort the entries in the Admin's
block and the icons on the Command and Control page alphabetically.</td></tr>
<tr>
<td valign="top"><a name="desc_link_documentation">link_documentation</a></td>
<td valign="top">1</td>
<td valign="top">Add a link to Geeklog's documentation to the Admin block.
Set this to 0 if you don't want that link to show up.</td></tr>
<tr>
<td valign="top"><a name="desc_link_versionchecker">link_versionchecker</a></td>
<td valign="top">1</td>
<td valign="top">Add a link "GL Version Test" to the Admin block so that you
can easily check if your Geeklog version is up to date. Set this to 0 if
you don't want that link to show up.<br />
<strong>Note:</strong> The link is only displayed to members of the Root
group anyway.</td></tr>
</table>
<h3><a name="blocks_topics">Blocks: Topics Block</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_sortmethod">sortmethod</a></td>
<td valign="top">alpha</td>
<td valign="top">alpha = Sort topics in topic list alphabetically<br />
sortnum = Sort topics in topic list by the given sort number</td></tr>
<tr>
<td valign="top"><a name="desc_showstorycount">showstorycount</a></td>
<td valign="top">1</td>
<td valign="top">Show the number of articles in a topic in the Sections block (0=no, 1=yes)</td></tr>
<tr>
<td valign="top"><a name="desc_showsubmissioncount">showsubmissioncount</a></td>
<td valign="top">1</td>
<td valign="top">Show the number of article submissions for a topic in the Sections block (0=no, 1=yes)</td></tr>
<tr>
<td valign="top"><a name="desc_hide_home_link">hide_home_link</a></td>
<td valign="top">0</td>
<td valign="top">Hide the "Home" link from the Sections block (0=no, 1=yes)</td></tr>
</table>
<h3><a name="blocks_who">Blocks: Who's Online Block</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_whosonline_threshold">whosonline_threshold</a></td>
<td valign="top">300</td>
<td valign="top">How long, in seconds, users can be idle before removing them from the whosonline block</td></tr>
<tr>
<td valign="top"><a name="desc_whosonline_anonymous">whosonline_anonymous</a></td>
<td valign="top">0</td>
<td valign="top">If enabled (i.e. set to 1), anonymous users will only see the number of registered users currently online in the Who's Online block but not their names. Only logged-in users will see the names of other users that are currently online.</td></tr>
<tr>
<td valign="top"><a name="desc_whosonline_photo">whosonline_photo</a></td>
<td valign="top">0</td>
<td valign="top">If enabled (i.e. set to 1), and a photo exists for the user, a thumbnail of that photo will be displayed. Else, a photo icon will be displayed.</td></tr>
</table>
<h3><a name="blocks_what">Blocks: What's New Block</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_newstoriesinterval">newstoriesinterval</a></td>
<td valign="top">86400</td>
<td valign="top">Articles are "new" if they are this many seconds old.</td></tr>
<tr>
<td valign="top"><a name="desc_newcommentsinterval">newcommentsinterval</a></td>
<td valign="top">172800</td>
<td valign="top">Comments are "new" if they are this many seconds old.</td></tr>
<tr>
<td valign="top"><a name="desc_newtrackbackinterval">newtrackbackinterval</a></td>
<td valign="top">172800</td>
<td valign="top">Trackback comments are "new" if they are this many seconds old.</td></tr>
<tr>
<td valign="top"><a name="desc_hidenewstories">hidenewstories</a></td>
<td valign="top">0</td>
<td valign="top">Set to 1 to hide new articles from the What's New block.</td></tr>
<tr>
<td valign="top"><a name="desc_hidenewcomments">hidenewcomments</a></td>
<td valign="top">0</td>
<td valign="top">Set to 1 to hide new comments from the What's New block.</td></tr>
<tr>
<td valign="top"><a name="desc_hidenewtrackbacks">hidenewtrackbacks</a></td>
<td valign="top">0</td>
<td valign="top">Set to 1 to hide new trackback comments from the What's New block.</td></tr>
<tr>
<td valign="top"><a name="desc_hidenewplugins">hidenewplugins</a></td>
<td valign="top">0</td>
<td valign="top">Set to 1 to hide new entries by plugins from the What's New
block.</td></tr>
<tr>
<td valign="top"><a name="desc_title_trim_length">title_trim_length</a></td>
<td valign="top">20</td>
<td valign="top">Max. length of the title of items listed in the What's New
block.</td></tr>
<tr>
<td valign="top"><a name="desc_whatsnew_cache_time">whatsnew_cache_time</a></td>
<td valign="top">3600</td>
<td valign="top">The What's New Block will be cached for no longer than this many seconds. If 0 caching is disabled.</td></tr>
</table>
<h2><a name="users">Users and Submissions</a></h2>
<h3><a name="users_users">Users and Submissions: Users</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_disable_new_user_registration">disable_new_user_registration</a></td>
<td valign="top">false</td>
<td valign="top">When set to <span class="tt">true</span> completely disables all options
to sign up as a new user.</td></tr>
<tr>
<td valign="top"><a name="desc_allow_user_themes">allow_user_themes</a></td>
<td valign="top">Can be 1 or 0</td>
<td valign="top">If set to 1, users can set their own theme that the site uses</td></tr>
<tr>
<td valign="top"><a name="desc_allow_user_photo">allow_user_photo</a></td>
<td valign="top">Can be 1 or 0</td>
<td valign="top">If set to 1, users can upload a photo to their profile</td></tr>
<tr>
<td valign="top"><a name="desc_allow_username_change">allow_username_change</a></td>
<td valign="top">0</td>
<td valign="top">If set to 1, users will be allowed to change their username
(login name). Articles and comments posted under the old username will
automatically show the new username.</td></tr>
<tr>
<td valign="top"><a name="desc_allow_account_delete">allow_account_delete</a></td>
<td valign="top">0</td>
<td valign="top">If set to 1, users will be allowed to delete their accounts. Articles and comments posted under that account will be kept and show up as being posted by "Anonymous".</td></tr>
<tr>
<td valign="top"><a name="desc_hide_author_exclusion">hide_author_exclusion</a></td>
<td valign="top">Can be 1 or 0</td>
<td valign="top">If set to 1, the option to to exclude certain authors from being seen is hidden from the user's preferences.</td></tr>
<tr>
<td valign="top"><a name="desc_show_fullname">show_fullname</a></td>
<td valign="top">0</td>
<td valign="top">Whether to display a user's full name (= 1) or only their
username (= 0). For users that haven't entered their full name, Geeklog
will always display the username.</td></tr>
<tr>
<td valign="top"><a name="desc_show_servicename">show_servicename</a></td>
<td valign="top">true</td>
<td valign="top">If you allow users to log in with accounts on remote services
(like LDAP), this option will at the service's name to
the username to avoid confusion with local users of the same name. Set to
<span class="tt">false</span> to disable.</td></tr>
<tr>
<td valign="top"><a name="desc_custom_registration">custom_registration</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">When set to <code>true</code>, Geeklog will let you use
your own signup form for new user registrations. Please see the file
<span class="tt">lib-custom.php</span> that ships with Geeklog for an example.</td></tr>
<tr>
<td valign="top"><a name="desc_user_login_method_standard">standard</a></td>
<td valign="top"><code>true</code></td>
<td valign="top">Whether to allow normal logins into the site, i.e. with
a user account that only exists in your site's database.</td></tr>
<tr>
<td valign="top"><a name="desc_user_login_method_openid">openid</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Whether to allow logins using <a href="http://openid.net/">OpenID</a>. This will display a special OpenID login below the normal login field.<br />
<strong>Note:</strong> Currently only OpenID 1.1 is supported.</td></tr>
<tr>
<td valign="top"><a name="desc_user_login_method_3rdparty">3rdparty</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Allow (when set to <span class="tt">true</span>) users who already have
an account with some other service to log into your Geeklog site with the
login for that service. Currently supported: LDAP.<br />
Please note that to enable login for a specific service, you need an
authorization class in <span class="tt">system/classes/authentication</span>. If you don't
want to allow LDAP users, simply
remove the class file for the unwanted service.<br />
See <a href="https://www.geeklog.net/article.php/remote-authentication">Remote Authentication in Geeklog</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_user_login_method_oauth">oauth</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Whether to allow logins using <a href="http://oauth.net/">OAuth</a>. This will display a special OAuth login below the normal login field.<br />
<strong>Note:</strong> Currently OAuth 1.0, 1.0a, and 2.0 is supported (depends on what the OAuth provider supports). Current login methods supported: Facebook, Twitter, LinkedIn, Google, Microsoft, and Yahoo.<br />
To enable logins for a specific method, you need to enable the method below and you must also update the config options with the correct key and secret string values.
The PHP extension OpenSSL is required to be loaded for OAuth logins to work.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_facebook_login">facebook_login</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Allow (when set to <span class="tt">true</span>) users who already have
an account with Facebook to log into Geeklog with said account using OAuth. You must set the Facebook application ID and secret.</td></tr>
<tr>
<td valign="top"><a name="desc_facebook_consumer_key">facebook_consumer_key</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Facebook OAuth login method. Visit this <a href="http://developers.facebook.com/setup/">Facebook Developers page</a>
to create an application to receive your key and secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_facebook_consumer_secret">facebook_consumer_secret</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Facebook OAuth login method. Visit this <a href="http://developers.facebook.com/setup/">Facebook Developers page</a>
to create an application to receive your key and secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_linkedin_login">linkedin_login</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Allow (when set to <span class="tt">true</span>) users who already have
an account with LinkedIn to log into Geeklog with said account using OAuth. You must set the LinkedIn API and secret key.</td></tr>
<tr>
<td valign="top"><a name="desc_linkedin_consumer_key">linkedin_consumer_key</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use LinkedIn OAuth login method. Visit this <a href="https://www.linkedin.com/secure/developer">LinkedIn Developers page</a>
to create an application to receive your API and secret key.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_linkedin_consumer_secret">linkedin_consumer_secret</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use LinkedIn OAuth login method. Visit this <a href="https://www.linkedin.com/secure/developer">LinkedIn Developers page</a>
to create an application to receive your API and secret key.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_twitter_login">twitter_login</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Allow (when set to <span class="tt">true</span>) users who already have
an account with Twitter to log into Geeklog with said account using OAuth. You must set the Twitter consumer key and secret.</td></tr>
<tr>
<td valign="top"><a name="desc_twitter_consumer_key">twitter_consumer_key</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Twitter OAuth login method. Visit this <a href="https://twitter.com/apps">Twitter Application page</a>
to create an application to receive your consumer key and secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_twitter_consumer_secret">twitter_consumer_secret</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Twitter OAuth login method. Visit this <a href="https://twitter.com/apps">Twitter Application page</a>
to create an application to receive your consumer key and secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_google_login">google_login</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Allow (when set to <span class="tt">true</span>) users who already have
an account with Google to log into Geeklog with said account using OAuth. You must set the Google client id and client secret.</td></tr>
<tr>
<td valign="top"><a name="desc_google_consumer_key">google_consumer_key</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Google OAuth login method. Visit the <a href="https://code.google.com/apis/console">Google Developers Console</a>
to create an application to receive your client ID and client secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_google_consumer_secret">google_consumer_secret</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Google OAuth login method. Visit the <a href="https://code.google.com/apis/console">Google Developers Console</a>
to create an application to receive your client ID and client secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_microsoft_login">microsoft_login</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Allow (when set to <span class="tt">true</span>) users who already have
an account with Microsoft to log into Geeklog with said account using OAuth. You must set the Microsoft client id and client secret.</td></tr>
<tr>
<td valign="top"><a name="desc_microsoft_consumer_key">microsoft_consumer_key</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Microsoft OAuth login method. Visit the <a href="http://go.microsoft.com/fwlink/?LinkId=248605">Microsoft Seller Dashboard</a>
to create an application to receive your client id and client secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_microsoft_consumer_secret">microsoft_consumer_secret</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Microsoft OAuth login method. Visit the <a href="http://go.microsoft.com/fwlink/?LinkId=248605">Microsoft Seller Dashboard</a>
to create an application to receive your client id and client secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_yahoo_login">yahoo_login</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Allow (when set to <span class="tt">true</span>) users who already have
an account with Yahoo to log into Geeklog with said account using OAuth. You must set the Yahoo consumer key and consumer secret.</td></tr>
<tr>
<td valign="top"><a name="desc_yahoo_consumer_key">yahoo_consumer_key</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Yahoo OAuth login method. Visit this <a href="http://developer.yahoo.com">Yahoo Developer page</a>
to create an application to receive your consumer key and consumer secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_yahoo_consumer_secret">yahoo_consumer_secret</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use Yahoo OAuth login method. Visit this <a href="http://developer.yahoo.com">Yahoo Developer page</a>
to create an application to receive your consumer key and consumer secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_github_login">github_login</a></td>
<td valign="top"><code>false</code></td>
<td valign="top">Allow (when set to <span class="tt">true</span>) users who already have
an account with GitHub to log into Geeklog with said account using OAuth. You must set the GitHub client id and client secret.</td></tr>
<tr>
<td valign="top"><a name="desc_github_consumer_key">github_consumer_key</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use GitHub OAuth login method. Visit this <a href="https://developer.github.com/v3/oauth/">GitHub Developer page</a>
to create an application to receive your client id and client secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_github_consumer_secret">github_consumer_secret</a></td>
<td valign="top"><code>''</code></td>
<td valign="top">Required to use GitHub OAuth login method. Visit this <a href="https://developer.github.com/v3/oauth/">GitHub Developer page</a>
to create an application to receive your client id and client secret.<br />
See our <a href="http://wiki.geeklog.net/index.php/OAuth">Wiki OAuth page</a> for more information.</td></tr>
<tr>
<td valign="top"><a name="desc_aftersave_user">aftersave_user</a></td>
<td valign="top"><code>'item'</code></td>
<td valign="top">Which page to go to after a user has been saved:
<ul>
<li>'item': display the user's profile</li>
<li>'list': show admin's list of users (default)</li>
<li>'home': display the site's homepage</li>
<li>'admin': go to the "Admin Home" page, i.e. Command & Control</li>
</ul></td></tr>
</table>
<h3><a name="users_spamx">Users and Submissions: Spam-X</a></h3>
<table border="1" width="100%">
<tr><th style="width:8%">Variable</th>
<th style="width:29%">Default Value</th>
<th style="width:63%">Description</th></tr>
<tr>
<td valign="top"><a name="desc_spamx">spamx</a></td>
<td valign="top">128</td>
<td valign="top">Tells Geeklog's <a href="spamx.html" rel="nofollow">Spam-X</a> plugin what to do when a spam post has been detected. The value is the sum
of all values that uniquely identify the Spam-X modules that should be
executed. E.g. the "delete" action module uses 128, the "email admin"
module uses 8, so if both modules should be executed, this option should
be set to 128 + 8 = 136.</td></tr>
</table>
<h3><a name="users_login">Users and Submissions: Login Settings</a></h3>