What is daCode?
Brief explanation: daCode is a news engine written in PHP. daCode focuses on modularity and speed/performance. Features include themes, user authentication, multi-languages support, a cache system, a templates system, and much more.
Longer explanation: daCode is a news engine written in PHP. It works with PHP 3 and 4, and requires a database (MySQL or PostgreSQL). It can also be used with LDAP or NIS in addition to the SQL database. daCode focuses on modularity and performance. Therefore, it is using classes, and a cache system. In other features, you can find themes (and a templates system), user authentication, multi-languages support, a board, a tips module, and much more.
For more infos, check out the official site of daCode, located at daCode.org.
daCode actually exists in two flavors: the stable one, and the unstable, buggy, for-developers-only one.
The latest stable build is the 1.2.0.
An unstable build is created every night (they are nightly builds).
It is highly recommanded that you choose the stable one. Download nightly builds only if you know what you do, are prepared for some problems, or want to help the development.
You have been warned.
If you want to develop with daCode, all the informations you'll need are there.
The project page on SourceForge.net is at this URI: http://sf.net/projects/dacode/.
We have a demo site, which uses the daily CVS version. It can be seen at demo.dacode.org.
If you see bugs, don't forget to report them.
· ChangeLog - All the changes made to the sources (the file is big, you've been warned).
· CURRENT - What we are working on right now.
· NEWS - The most important changes briefly explained.
· TODO - What is to do.
The CVS repository of daCode is actually in SourceForge.net.
You can browse it through your web browser at this URI:
Here's what you have to type in your shell to get an up-to-date CVS version of daCode:
cvs -d:pserver:email@example.com:/cvsroot/dacode login
Press [backspace] (or [Enter]) when you're asked for a Password.
cvs -z3 -d:pserver:firstname.lastname@example.org:/cvsroot/dacode co daCode
For the next updates, you'll just have to type cvs update in your daCode directory to update your local version of daCode.
Note that this is just for users who are not listed in the developers of daCode. If you're listed on this page, we assume that you know how all that works.
Nightly builds are created every night with the content of the current CVS repository.
They are very useful for those who don't have any access to CVS but want to help.
Want the latest? Just click here.
PLEASE read doc/RULES.
Best way to submit portions of code is to create patches.
To do so, you'll need to use diff (always with the -u argument).
It's very easy to use when you have a CVS access. Just type:
cvs diff -u > ~/dacode.patch
To add a new file, just type this:
diff -u /dev/null src/htdocs/newfile.php3 >> ~/dacode.patch
If you don't have any CVS access, it's a bit less easy.
You'll need to untar your nightly build two times, under two different names. Use daCode.orig for the first, and daCode for the second. Then make all your modification in the directory called daCode, and none in the one called daCode.orig. When you're finished, type:
diff -ur -I "^[-# *]*\$Id[:,_./a-zA-Z0-9 -]*\$$" --exclude CVS daCode.orig daCode > ~/dacode.patch
And to add new files:
diff -uNr --exclude CVS daCode.orig daCode > ~/dacode.patch
When your patch is ready, send it to dacode-dev.
daCode can be used with Windows without major problem.
daCode runs under Windows with Apache and PHP 3 or 4. It also runs under Windows with IIS 5 and PHP 3 or 4.
If you are coding under Windows, you'll need a code editor that accepts Unix new lines ("\n" for Unix instead of "\r\n" for Windows). You'll also need CygWin to use the CVS repository and to create patches.
If you have written an application or a script related to daCode, you can have it added in the contrib/ dir of daCode.
Please read contrib/README for more details.
Art & themes:
If you want to create logos, images, or whatever else inspired by daCode, feel free to do so, we will be pleased. You can also email us to let us know it.
If you have designed a new daCode theme, and want it to be added to daCode, you too have to email us. We will decide whether we include it or not.
The official site of daCode is daCode.org.
Developers have their mailing-lists (dacode-dev and dacode-cvs). See below for more infos.
If you have problems with daCode's installation, difficulties with a function, no ability to understand how themes are working, etc, you have two ways to see your problem be resolved.
Note that in both cases, the same people will read you, because the tracker redirects your query to the mailing-list.
You can also join us on irc.openprojects.net, channel #daCode.
No less than six (6) mailing-lists are devoted to daCode. Each one, hosted on the same server than daCode.org, has its own use.
All these lists are both french and english speaking. You can try another language, but it is highly doubtful that you will get any other answer than "What?" or "Je ne comprends pas".
This low-traffic list contains the announces of new versions of daCode.
Email this list if you need help or have any problems with daCode.
The "support request" tracker from SourceForge.net has a follow-up to this list.
Remember to detail your problem, and to give your version of daCode.
This list is devoted to bug reports and how to fix them.
Bugs posted through SourceForge.net are automatically posted in this list too.
If you want to see a new feature in daCode but don't know how to code it, just email it there.
Feature requests from SourceForge.net are posted there too.
Want to discuss of daCode's development? Want to submit a patch? This list is made for you.
Note that the patches sent through SourceForge.net are redirected there.
All changes made to the code in the CVS repository are automatically reported there.
This list can be very active.
If your patches are really very big, post them there instead of dacode-dev.
Some useful links: