- Trace a request
- Follow a chat message
- Change registration or member handling
- Add a setting or change the news editor
- Change a page or its wording
- Run the chat locally
- Browse the file index
Trace a request
cgi-bin/chat.pl- Start here to trace a CGI request through startup, configuration, and dispatch.
cgi-bin/Sources/RequestContext.pm- Check the per-request state when a value survives unexpectedly in a persistent worker.
cgi-bin/Settings.static.dat- Find the module registered for an action, slash command, template variable, or hook.
Follow a chat message
cgi-bin/Sources/SendRequest.pm- Start at the send request and follow its validation and submission handling.
cgi-bin/Sources/Send.pm- Follow command dispatch, filter hooks, and selection of recipients.
cgi-bin/Sources/RecipientDelivery.pm- Trace how messages reach the selected sessions.
cgi-bin/Sources/DeliveryJournal.pm- Look here for cursors and replay on the experimental delivery path.
cgi-bin/Sources/RoomHistory.pm- Check which recent room messages are stored and can be restored.
www/message-events.js- Trace how the browser turns a typed event into an update to the transcript or roster.
Change registration or member handling
cgi-bin/Sources/Register.pm- Follow form submission through account creation.
cgi-bin/Sources/RegistrationPolicy.pm- Change or check the rules for names, email patterns, age, and approval.
cgi-bin/Sources/AccountGateway.pm- Use the account boundary when looking up or changing a registered member.
cgi-bin/Sources/MemberIndex.pm- Inspect nickname lookup and the index used by the directory and search.
Add a setting or change the news editor
cgi-bin/SiteSettings.default.dat- Set the defaults for new installations. Existing installations can have their own saved values.
cgi-bin/Plugins/Administration/Settings.pm- Find the admin action that validates and saves the corresponding form.
cgi-bin/Sources/SettingsStore.pm- Follow version checks and persistence for site settings.
cgi-bin/Plugins/Administration/News.pm- Follow article preview, publishing, and deletion.
cgi-bin/Templates/admin/news_edit.html- Edit the fields and actions in the article form.
Change a page or its wording
cgi-bin/Templates/login.html- Start with this template to change the public sign-in page.
cgi-bin/Templates/chat.html- Change the structure of the chat shell. The template includes the composer, toolbar, roster, and transcript frame.
www/style.css- Find shared styles for public pages, chat, administration, and the light and dark palettes.
cgi-bin/english.lng- Add an English label and give its German translation the same key in german.lng.
cgi-bin/german.lng- Add the corresponding German text. The shared templates use translation keys.
Run the chat locally
README.md- Start here for prerequisites, the first installation, and web server examples.
tools/run-local.sh- Start the developer CGI server and point it at your local installation.
tools/local_server.py- Inspect how the local server serves assets and forwards a request to Perl.