README
author Dan
Thu, 17 Dec 2009 04:27:50 -0500
changeset 1168 277a9cdead3e
parent 1087 c3db5e44f8f3
child 1273 3351055b467e
permissions -rw-r--r--
Namespace_Default: added a workaround for an inconsistency in SQL. Basically, if you join the same table multiple times under multiple aliases, COUNT() always uses the first instance. Was affecting the comment counter in the "discussion" button.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
     1
Enano CMS
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
     2
Version 1.1.7
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
     3
-----------------------------
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
     4
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
     5
Thanks for downloading Enano! If you're looking for an installation guide,
234
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
     6
you can find it at <http://docs.enanocms.org/Help:2.1>.
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
     7
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
     8
COPYRIGHT
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
     9
-----------------------------
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    10
234
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    11
Enano CMS
801
eb8b23f11744 Two big commits in one day I know, but redid password storage to use HMAC-SHA1. Consolidated much AES processing to three core methods in session that should handle everything automagically. Installation works; upgrades should. Rebranded as 1.1.6.
Dan
parents: 751
diff changeset
    12
Copyright (C) 2006-2009 Dan Fuhry. All rights except those explicitly granted
234
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    13
by the included license agreement reserved.
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    14
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    15
PHILOSOPHY
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    16
-----------------------------
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    17
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    18
We strongly believe in the idea of Free Software. Enano is released under the
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    19
GNU General Public License; see the file GPL included with this release for
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    20
details.
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    21
234
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    22
LICENSING
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    23
-----------------------------
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    24
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    25
This program is Free Software; you can redistribute it and/or modify it under
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    26
the terms of the GNU General Public License as published by the Free Software
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    27
Foundation; either version 2 of the License, or (at your option) any later
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    28
version.
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    29
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    30
This program is distributed in the hope that it will be useful, but WITHOUT ANY
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    31
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    32
PARTICULAR PURPOSE. See the GNU General Public License for details.
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    33
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    34
You should have received a copy of the GNU General Public License along with
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    35
this program; if not, write to:
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    36
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    37
  Free Software Foundation, Inc.,
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    38
  51 Franklin Street, Fifth Floor
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    39
  Boston, MA 02110-1301, USA
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    40
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    41
-----------------------------
d5dff8148dfe Renaming config.php and .htaccess to *.new to allow tarbombing an Enano installation with no adverse effects; first attempt, may not work right.
Dan
parents: 120
diff changeset
    42
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    43
Most of the PHP code in Enano was written by Dan Fuhry. Some parts were borrowed
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    44
from other projects that are also released under Free licenses; see the various
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    45
files under the licenses/ directory included with this release for details.
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    46
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    47
CHANGES IN THIS RELEASE
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    48
-----------------------------
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    49
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    50
Please see <http://enanocms.org/Release_notes/1.1.7> for a list of changes in
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    51
this release.
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    52
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    53
UPGRADING FROM PREVIOUS RELEASES
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    54
-----------------------------
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    55
685
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
    56
This archive includes a script that can migrate an Enano 1.0.x installation to
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    57
Enano 1.2. Before running the migration script, you should always be sure to
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    58
upgrade to the latest version of Enano 1.0.x (1.0.7 "FIXME" at the time of
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    59
this writing). Migration is NOT REVERSIBLE. This is beta-quality code. DO NOT
685
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
    60
UNDER ANY CIRCUMSTANCES UPGRADE A PRODUCTION SITE.
392
3395ecddd831 Updated readme file for 1.1.1
Dan
parents: 320
diff changeset
    61
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    62
Upgrades from any 1.1.x version are fully supported and generally more stable
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    63
than upgrades from 1.0 because of all the API changes. If you experience
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    64
trouble upgrading from a 1.0 version to 1.2, try upgrading first to version
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    65
1.1.6 or so.
428
921bae9104b0 Updated readme file for 1.1.2 release
Dan
parents: 392
diff changeset
    66
392
3395ecddd831 Updated readme file for 1.1.1
Dan
parents: 320
diff changeset
    67
TRANSLATING ENANO
3395ecddd831 Updated readme file for 1.1.1
Dan
parents: 320
diff changeset
    68
-----------------------------
3395ecddd831 Updated readme file for 1.1.1
Dan
parents: 320
diff changeset
    69
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    70
There have been quite a few changes to strings in the 1.2 series. Since this
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    71
is a beta, you probably don't want to do a lot of translation because you'll
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    72
be doing a TON more strings at every release. HOWEVER, we're looking for
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    73
people to sign up and volunteer for translation efforts later on. If you have
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    74
a native or very good knowledge of a language, drop us an e-mail and we'll get
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    75
you onto the translator list and eventually onto a mailing list specifically
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    76
for l10n if that effort becomes big enough.
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    77
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    78
PLUG-INS
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    79
-----------------------------
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    80
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    81
Most Enano features you see are actually the work of plugins. You can see a
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    82
gallery of plugins at <http://enanocms.org/Category:Plugins>. Most of the
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    83
plugins there work under Enano 1.2, but some don't. Plugins with known
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    84
compatibility problems are marked; if you don't see any notes to the
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    85
contrary, it's probably compatible with Enano 1.2.
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    86
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    87
THEMES
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    88
-----------------------------
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    89
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
    90
You can find more themes for Enano at <http://enanocms.org/Category:Themes>.
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    91
We're not doing too great with developing themes, and what we have developed
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    92
often doesn't make it up to the website. :) So your choices on the website
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    93
look a little bit more limited than they really are.
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    94
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    95
Unlike plugins, themes are generally very easy to port from 1.0 to 1.2. Copy
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    96
over acledit.tpl, comment.tpl, and toolbar.tpl from a 1.2 theme and remove
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    97
the <script> tag that includes jsres.php, replacing it with {JS_HEADER} in
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    98
header.tpl. Then put {JS_FOOTER} right before </body> in footer.tpl. Do the
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
    99
same in simple_header.tpl and simple_footer.tpl. That's pretty much it.
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
   100
685
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
   101
PLUGIN DEVELOPMENT
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
   102
-----------------------------
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
   103
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
   104
The plugin API in Enano 1.1 has been dramatically revamped from 1.0. Some
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
   105
effort has been made to allow 1.0.x plugins that don't hook very deeply to
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
   106
continue to work; however with all of the new functionality (localization
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
   107
especially) we recommend that developers take the time to learn how to use the
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
   108
newer parts of the Enano platform. Enano tries to be very developer-friendly;
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
   109
our full API documentation is at <http://docs.enanocms.org/API>.
685
17ebe24cdf85 Rebranded as 1.1.5 (Caoineag alpha 5) and fixed a couple bugs related to CDN support in template_nodb and installerUI. Updated readme.
Dan
parents: 634
diff changeset
   110
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
   111
GETTING SUPPORT
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
   112
-----------------------------
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
   113
1087
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
   114
This is a beta release. No support of any kind will be provided, but proper bug
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
   115
reports are appreciated. See the Enano forums at <http://forum.enanocms.org/>
c3db5e44f8f3 Updated readme for 1.1.7/1.2 series in general
Dan
parents: 801
diff changeset
   116
for more information.
69
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
   117
63638a42cee9 Removed KNOWN_BUGS and TODO and added README; fixed file permissions yet again
Dan
parents:
diff changeset
   118
Have fun with Enano!