One can use the Start page
option for that. The entry:
Start page = 0?cmd=last
shows the last message entry by default. To have the described behaviour for
all logbooks, the above statements can be placed in the [global]
section.
No. The idea behind ELOG is that it is a simple to use, simple to install application. Many people use ELOG under Windows, and they even don't know what MySQL means. Other people like the flat file database format, because it's simple, easily accessible from other programs, and it's easy to backup certain days or months of the database (since the filenames contain the date). Since ELOG should be independent of any other package, some "switchable" backend between native ELOG format and MySQL would be needed, which is lots of work and not planned right now.
However, there are several contributions from other people who wrote scripts to put ELOG entries into a MySQL database. One is available at http://midas.psi.ch/elogdemo/Forum/387.
No. The ELOG daemon was designed as a standalone server and it will stay like that in the future.
The reason for that is that elogd
should not rely on any other software. This is for
example important for many people running elogd
under Windows, and they have no clue
how to install Apache for Windows. The installation and maintenance for elogd
therefore becomes much simpler. To run elogd
in parallel to an Apache server on
port 80, use Apache as a proxy, following the instruction on the installation page
("Running elogd under Apache").
By default, no password is used in ELOG. This can be useful for public directories etc. that anybody should be able to read. To add password security, read the documentation under Access control. The recommended setup is password file security with guest access.
Note that passwords are transferred over the network in plain text and therefore not secure. If this is a problem, a secure network connection should be used.
Use the URL:
http://<your.host>/<logbook>/?cmd=Last&<attribute>=<value>
This executes the "Last" command using a filter with <attribute>=<value>. The following command displays the same page, but also locks the attribute (checks the box next to <attribute>) so that browsing (next, previous, first, last) only shows pages with that attribute value.
http://<your.host>/<logbook>/?cmd=Last&<attribute>=<value>&l<attribute>=1
Note the "l" before the second attribute, as in "lAuthor=1".
In an old version of the FAQ it has been stated here that one has to use two logbooks pointing to the same data directory. From Version 2.0.6 on, this can be accomplished much easier by the usage of the "Guest menu command". Use a logbook with user level access (password file), and add menu lists like in the following example to the configuration file:
Menu commands = New, Edit, Reply, Find, Last 10, Change password, Logout, Help
Guest menu commands = Find, Last 10, Login, Help
If users access the logbook without supplying a user name, they are treated like "guests" and see the "Guest menu commands", with which one cannot submit or edit logbook entries. If one hits the "login" button, a user can login with a user name/password and sees the normal menu commands, with which one can submit new logbook entries.
An optional self registration is possible by specifying
Self register = 1
in the configuration file. New users can then create their own accounts.
You can have several logbooks point to the same password file. So if you change a user or password in that file, it becomes automatically available in all logbooks which use that file.
There is a simple trick. You use the "Start page" option in the elogd
file
to redirect the start page to something else. Here are some examples:
?npp=5 for the last 5 messages ?last=7 show last 7 days (week) ?cmd=New show the new message entry form ?cmd=Find Show the "find" page ?cmd=Search&<attrib>=<value> for a search with <attrib>=<value>The various URLs can be copied from the browser's address bar when doint various things there.
New commands can be added for example with the "Bottom text = bottom.html"
option.
To display all messages from last week and month of with "category = info", one can put
following HTML code in bottom.html:
<center> <a href="?last=7&Category=Info">Info from last week</a> | <a href="?last=31&Category=Info">Info from last month</a> | </center>
Note that the parameters "last=7&Category=Info"
applies a filter on the display. You can learn
how to make these filters by looking at the URL in your browser when you submit a find
command with certain options.
This works with the option Menu commands
. By default, the menu commands
Back, New, Edit, Delete, Reply, Find, Config, Help
are dispalyed and allowed. To avoid
editing (and deleting) of existing messages, one removes the two commands and puts following
statement into elogd.cfg
:
Menu commands = Back, New, Reply, Find, Config, Help
This prohibits the execution of the commands "Edit" and "Delete".
There are two ways:
Attributes = Author, ..., Revisions Locked attributes = Revisions Subst on Edit Revisions = $Revisions<br>$date by $long_nameThe "Revisions" attribute cannot be modified manually (since it's locked). On each edit, the date and the current author is appedned to the previous revisions. The "<br>" puts a line break between the entries.
Reply string = ""then the reply contains the original message without the usual "> " at the beginning of each line. One can then edit the message and submit it. In the threaded message list display, one sees then the different revisions as a message thread.
Usually, the current date/time is recorded when you add a new entry. It might be, however, that one wants to enter "old" entries, or some entries with a date in the future (like a to-do list with a due date). To do that, on can add a new attribute (let's call it Record date, to be different from the pre-defined Date:
Attributes = Author, ..., Record date
Type Record date = date
Preset Record date = $date
Date format = %Y %m %d
List Display = Record date, Author, ...
Start page = ?rsort=Record date
The Preset Record date statement sets the record date to the current date, but this can then of course edited during the message entry. The List Display and Start page statements show the record date as the first column in the summary display and also sort by that. Note the Date format showing first year, then month and day. This is necessary since sorting is done only lexically. Please note that the List Display was renamed recently. Prior to version 2.3.10, it was called Display Search.
This can happen if you change the login policy, for example move the Password file =
entry
in the configuration file from a logbook section to the [global] section or back. In that case some old cookies
could be stored in your browser, which confuse the system. Please delete your cookies in the browser to resolve
this problem. Read your browser documentation on how to do that.
This is a typical request of a bug-tracking set-up. Someone enters a request, opening a new thread. The expert(s) reply to the the request, and after a while, the request gets satisfied or the problem gets fixed. If an attribute like "status", having the options "open" and "fixed" could get changed for the whole thread, on could very easily search for all "open" problems.
Since this functionality is not implemented, an alternative strategy is recommended: Implement two (or more) logbooks. The first logbook has open issues, the second one has fixed ones. When an entry changes state, it simply has to be copied to the second logbook. This can be done by defining the menu command "move" in the config file, like:
Menu commands = Back, New, Edit, Delete, Reply, Find, Move to, Config, Help
Note the additional Move to. This solution is even more elegant than having attributes changed in whole threads, since one has two separate logbooks, and can treat the second one more like an archive, make separate back-ups, or deleting some entries after some time, while keeping the open issues untouched.
RSS feeds normally only work for logbooks which have at least public read access (via
the guest menu commands). There is however a way to allow only restricted read access
and still use RSS feeds. This is done by adding an additional read password via the
elogd -r <pwd> -l <logbook>
command. This password
(username may be any) can then be used in an RSS reader for restricted access. One reader
which has been successfully used with this kind of authentication is
RSSReader.
Sometime people want to mark a whole thread in a way. An example is a to-do list, where they want a special icon on high priority things, and have this icon disappear one the task is finished. This can be easily done with icons. The configuration could look like this:
Attributes = Author, Status, Subject IOptions Status = icon1.gif, icon2.gif, icon4.gif Preset Status = icon4.gif Preset on reply status = icon2.gif Icon comment icon1.gif = Closed entry Icon comment icon4.gif = Open entry Thread display = $Author $Subject Thread icon = Status
New entries get an exclamation mark icon for example ("Preset status = ..."). Replies to this entry get a reply icon. Once the thread should be closed, one simple edits the top entry in that thread and changes the icon. The icon1.gif from the distribution is maybe not ideally suited for that, but one could make a green check mark icon for example for that. The "Thread display" and "Thread icon" make this icon appear at the left side of the threaded display.
An alternative approach would be to use two logbooks. The first one receive all new entries ("open items"). Once an entry (with its replies) gets closed, it must be moved manually to the second logbook ("closed items"). This can be done with the "Move To" command (see "menu commands" in config file). This way one nicely separates open and closed items in two separate logbooks. One can still search both logbooks at the same time if one checks "Search all logbooks" in the find page.
No, but you can use any spell checker which works with your browser. Examples are IESpell for Internet Explorer and SpellBound for Mozilla-based browsers.