\documentclass{article}
\usepackage{ulem}
\usepackage{graphicx}
\usepackage{hyperref}
\pagestyle{headings}
\begin{document}
\part{Agora}
Agora is Horde's forum module, providing comments on user submitted content in e.g. <a href="https://wiki.horde.org/Project/Ansel">Ansel</a> or <a href="https://wiki.horde.org/Project/Jonah">Jonah</a>.

\section{Bugs}
List any tickets on <a href="http://bugs.horde.org/">http://bugs.horde.org/</a> that cover this issue or are relevant to it.

\section{People}
\begin{itemize}
\item Stephan (webmaster <ät> dasourcerer <döt> net)


\item Almost certainly others


\end{itemize}
\section{Features}
\begin{itemize}
\item Structure


\end{itemize}
\begin{quote}
Introduce categories for boards as an additional means organization. For larger installations, boards alone might be insufficient.


\end{quote}
<pre><code>
 Categories
  + Boards
     + Threads
        + Thread pages
        + Posts
           + Attached files
</code></pre>
\begin{itemize}
\item Pretty URLs


\end{itemize}
\begin{quote}
Apart from being just "pretty", URLs should express is-a, has-a or subset relations. Examples:


\end{quote}
<pre><code>
http://example.com/horde/agora/main/testboard/testthread/page/3\#post-9365
  Category titled "Main"     --´     |         |          |   |  |
  Board titled "Testboard"   -------´          |          |   |  |
  Thread titled "Testthread" -----------------´           |   |  |
  Show page 3 of the thread  ----------------------------´---´   |
  Jump directly to post \#9365 ----------------------------------´

http://example.com/horde/agora/main/testboard/testthread/9365/edit
  Category titled "Main"     --´     |         |          |    |
  Board titled "Testboard"   -------´          |          |    |
  Thread titled "Testthread" -----------------´           |    |
  Post with the id 9365      ----------------------------´     |
  (there is little sense in naming individual posts)           |
  Action: Edit post \#9365    ---------------------------------´

http://example.com/horde/agora/recent/page/3
  List threads that got     ----´      |   |
  recent replies                       |   |
  Show page three           ----------´---´
</code></pre>
\begin{quote}
In order to create a named URL part, the following operations should be performed:<br />
* Strip trailing or leading whitespaces<br />
* Transform all letters into lower case<br />
* Translate all letters not within a-z into their phonetic equivalents. Examples:<br />
| Original Letter | ä | ß | ø | ð |<br />
| --- | --- | --- | --- | --- |<br />
| Equivalent | ae | ss | oe | th |<br />
* Turn everything except a-z and 0-9 into a dash ("-")<br />
* Merge multiple dashes into one<br />
* In case of a collision: Append a dash followed by the number of colliding strings + 1 (should result into "foobar", "foobar-2", "foobar-3", etc.)


\end{quote}
\begin{itemize}
\item Statistics


\end{itemize}
\begin{quote}
People \textit{*love*} statistics. Providing them also seems to encourage user participation. In particular, provide a publicly available stats page featuring:<br />
* Top \textit{n} most active users (by post count)<br />
* Top \textit{n} most popular boards (by post count \textit{or} by views)<br />
* Top \textit{n} most popular threads (by post count \textit{or} by views)<br />
* Last \textit{n} threads (possibly drop this in favour of /recent)<br />
* Generic stats like:<br />
>>* Total number of threads<br />
>>* Total number of posts<br />
>>* Average number of posts per thread (bonus: Use this to determine "hot threads" instead of a fixed value)<br />
>>* Average number of posts per day and per hour (seems to be bogus, but people like it. And it is cheap to generate: Take the first and devide by 24)<br />
* Overview over the number of posts on each of the last \textit{n} days<br />
Possibly provide all of these via blocks as well.


\end{quote}
\begin{itemize}
\item Syndication


\end{itemize}
\begin{quote}
Provide RSS and Atom feeds (c.f. <a href="https://wiki.horde.org/Project/FeedEverything">Project/FeedEverything</a>). In particular:<br />
* Feed solely for threads (e.g. newly created threads will be announced in here, showing the content of the very first post in the feed entry.)<br />
* Full content feed (All new posts go in here)<br />
* Both again for specific boards (this is excellent for larger installations with high traffic)


\end{quote}
\begin{itemize}
\item Moderation


\end{itemize}
\begin{quote}
Currently, there can be only one moderator per board. Add an extra table to allow for an n:n boards-to-moderators relation.<br />
Also: Allow moderators to perform reversive actions in boards not assigned to them, tying them closer to their assigned boards.


\end{quote}
\begin{itemize}
\item Linkback


\end{itemize}
\begin{quote}
Enable threads to accept ping- and trackbacks. In addition, catch refbacks.


\end{quote}
\begin{itemize}
\item Plugin Infrastructure


\end{itemize}
\begin{quote}
Forums are often subjects to heavy modifications in an effort to appease users. A powerful plugin infrastructure might help to keep the installed software maintainable while allowing the desired modifications. The <a href="http://www.habariproject.org">Habari Project</a> has got a system that might be a good start for this.


\end{quote}
\subsection{BBCode}
An advanced BBCode parser has been proposed a <a href="http://bugs.horde.org/ticket/7285">long time ago</a>. Since then, a better one has been in the making. Features include:

\begin{itemize}
\item Inspect links regarding availability. Examples:


\end{itemize}
<pre><code>
www.example.com
</code></pre>
\begin{quote}
or


\end{quote}
<pre><code>
[url]http://www.example.com[/url]
</code></pre>
\begin{quote}
would be rendered as


\end{quote}
<pre><code>
<a href="http://www.example.com" title="Example Site" type="text/html" target="\_blank">http://www.example.com</a>
</code></pre>
\begin{quote}
Unreachable links would be marked with \textit{rel="nofollow"}, so there won't be an impact on search engine rating:


\end{quote}
<pre><code>
<a href="http://www.example.com" rel="nofollow" target="\_blank">http://www.example.com</a>
</code></pre>
\begin{quote}
Additionally, CSS selectors could be used to give users an immediate feedback on broken links.


\end{quote}
\begin{itemize}
\item Inspect embedded images


\end{itemize}
\begin{quote}
Check if:<br />
* an <a href="https://wiki.horde.org/img">img</a> tag is pointing to a reachable destination<br />
* if the destination is actually an image (the rise of one-click-image-hosters seems to entice users to c\&p the URLs of result pages rather than the URLs of the actual images)<br />
* Eventually, retrieve the image dimensions.<br />
As an example


\end{quote}
<pre><code>
[img]http://www.example.com/example.png[/img]
</code></pre>
\begin{quote}
would be rendered as


\end{quote}
<pre><code>
<img src="http://www.example.com/example.png" alt="http://www.example.com/example.png" title="example.png (65536 bytes)" width="640" height="480" />
</code></pre>
\begin{itemize}
\item Enhanced quotes


\end{itemize}
\begin{quote}
The <a href="https://wiki.horde.org/quote">quote</a> tag has got an optional parameter that can hold three different kinds of values: A quoted string, the id of a post or an URL. The last two will be using the <a href="http://microformats.org/wiki/cite-rel">cite-rel microformat</a> in the rendered output. Example:


\end{quote}
<pre><code>
[quote=http://www.horde.org]
Welcome to the home of the Horde Project.
[/quote]
</code></pre>
\begin{quote}
Will be rendered as:


\end{quote}
<pre><code>
<div class="quote">
Quote <cite class="via" id="cite-ef58e3aa-af7f-45ba-a17d-5192ffe883b7"><a href="http://www.horde.org" type="text/html" target="\_blank">The Horde Project</a></cite>:
  <blockquote cite="\#cite-ef58e3aa-af7f-45ba-a17d-5192ffe883b7">
    Welcome to the home of the Horde Project.
  </blockquote>
</div>
</code></pre>
\begin{quote}
Using a post id will in addition show the username of the original poster


\end{quote}
\subsection{Features touching other modules}
\begin{itemize}
\item <a href="https://wiki.horde.org/Project/Ansel">Ansel</a> could be utilized to provide (more or less) one-click-hosting out of Agora, offering a convenient method to publish images within posts.


\item <a href="https://wiki.horde.org/Project/Scry">Scry</a>. Create polls via API calls and tie them into Agora in an 1:1 relation (meaning there will be at most one poll per thread)


\item <a href="https://wiki.horde.org/Project/Trean">Trean</a>. Keeping track of larger forums is hard. Allow users to bookmark threads via Trean. Preserve Agora's logical structure (categories, boards) when displaying them. Bonus: Provide an Atom/RSS feed for bookmarked threads only.


\item <a href="https://wiki.horde.org/Project/Folks">Folks</a>. Link usernames to profiles in Folks accordingly.


\item Possibly provide comments functionality for <a href="https://wiki.horde.org/Project/Whups">Whups</a> and <a href="https://wiki.horde.org/Project/Wicked">Wicked</a>


\end{itemize}
\section{Code}
\begin{itemize}
\item H3: <a href="http://cvs.horde.org/agora">http://cvs.horde.org/agora</a>


\item H4: <a href="http://git.horde.org/browse/agora/browsedir.php?f=agora%2F\&amp;onb=master">http://git.horde.org/browse/agora/browsedir.php?f=agora\%2F\textbackslash\{\}\&onb=master</a>


\end{itemize}
\section{Resources}
\begin{itemize}
\item <a href="http://dev.horde.org/api/agora/">API Documentation</a>


\end{itemize}

\noindent\rule{\textwidth}{1pt}
Back to the <a href="https://wiki.horde.org/Project">Project List</a>

\end{document}
