2 * Blog view renderer module for WebCit
4 * Copyright (c) 1996-2011 by the citadel.org team
6 * This program is open source software. You can redistribute it and/or
7 * modify it under the terms of the GNU General Public License as
8 * published by the Free Software Foundation -- either version 3 of the
9 * License, or (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #include "webserver.h"
27 * Generate a permalink for a post
28 * (Call with NULL arguments to make this function wcprintf() the permalink
29 * instead of writing it to the template)
31 void tmplput_blog_permalink(StrBuf *Target, WCTemplputParams *TP) {
34 strcpy(perma, "/readfwd?go=");
35 urlesc(&perma[strlen(perma)], sizeof(perma)-strlen(perma), (char *)ChrPtr(WC->CurRoom.name));
36 snprintf(&perma[strlen(perma)], sizeof(perma)-strlen(perma), "?p=%d", WC->bptlid);
38 wc_printf("%s", perma);
41 StrBufAppendPrintf(Target, "%s", perma);
47 * Render a single blog post and (optionally) its comments
49 void blogpost_render(struct blogpost *bp, int with_comments)
54 WC->bptlid = bp->top_level_id; /* This is used in templates; do not remove it */
56 /* Always show the top level post, unless we somehow ended up with an empty list */
57 if (bp->num_msgs > 0) {
58 read_message(WC->WBuf, HKEY("view_blog_post"), bp->msgs[0], NULL, &Mime);
62 /* Show any existing comments, then offer the comment box */
63 wc_printf("<a name=\"comments\"></a>\n");
64 wc_printf(_("%d comments"), bp->num_msgs - 1);
65 wc_printf(" | <a href=\"");
66 tmplput_blog_permalink(NULL, NULL);
67 wc_printf("\">%s</a>", _("permalink"));
69 for (i=1; i<bp->num_msgs; ++i) {
70 read_message(WC->WBuf, HKEY("view_blog_comment"), bp->msgs[i], NULL, &Mime);
72 do_template("view_blog_comment_box");
76 /* Show only the number of comments */
77 wc_printf("<a href=\"readfwd?p=%d?go=", bp->top_level_id);
78 urlescputs(ChrPtr(WC->CurRoom.name));
79 wc_printf("#comments\">");
80 wc_printf(_("%d comments"), bp->num_msgs - 1);
81 wc_printf("</a> | <a href=\"");
82 tmplput_blog_permalink(NULL, NULL);
83 wc_printf("\">%s</a>", _("permalink"));
84 wc_printf("<br><br><br>\n");
90 * Destructor for "struct blogpost"
92 void blogpost_destroy(struct blogpost *bp) {
93 if (bp->alloc_msgs > 0) {
101 * Entry point for message read operations.
103 int blogview_GetParamsGetServerCall(SharedMessageStatus *Stat,
109 HashList *BLOG = NewHash(1, NULL);
110 *ViewSpecific = BLOG;
112 Stat->startmsg = (-1); /* not used here */
113 Stat->sortit = 1; /* not used here */
114 Stat->num_displayed = DEFAULT_MAXMSGS; /* not used here */
115 if (Stat->maxmsgs == 0) Stat->maxmsgs = DEFAULT_MAXMSGS;
117 /* perform a "read all" call to fetch the message list -- we'll cut it down later */
118 rlid[2].cmd(cmd, len);
125 * Given a msgnum, populate the id and refs fields of
126 * a "struct bltr" by fetching them from the Citadel server
128 struct bltr blogview_learn_thread_references(long msgnum)
133 struct bltr bltr = { 0, 0 } ;
136 serv_printf("MSG0 %ld|1", msgnum); /* top level citadel headers only */
137 StrBuf_ServGetln(Buf);
138 if (GetServerStatus(Buf, NULL) == 1) {
139 while (len = StrBuf_ServGetln(Buf),
141 ((len != 3) || strcmp(ChrPtr(Buf), "000") )))
143 if (!strncasecmp(ChrPtr(Buf), "msgn=", 5)) {
144 StrBufCutLeft(Buf, 5);
145 bltr.id = ThreadIdHash(Buf);
147 else if (!strncasecmp(ChrPtr(Buf), "wefw=", 5)) {
148 StrBufCutLeft(Buf, 5); /* trim the field name */
149 StrBufExtract_token(r, Buf, 0, '|');
150 bltr.refs = ThreadIdHash(r);
161 * This function is called for every message in the list.
163 int blogview_LoadMsgFromServer(SharedMessageStatus *Stat,
165 message_summary* Msg,
169 HashList *BLOG = (HashList *) *ViewSpecific;
171 struct blogpost *bp = NULL;
174 b = blogview_learn_thread_references(Msg->msgnum);
176 /* Stop processing if the viewer is only interested in a single post and
177 * that message ID is neither the id nor the refs.
179 p = atoi(BSTR("p")); /* are we looking for a specific post? */
180 if ((p != 0) && (p != b.id) && (p != b.refs)) {
185 * Add our little bundle of blogworthy wonderfulness to the hash table
188 bp = malloc(sizeof(struct blogpost));
189 if (!bp) return(200);
190 memset(bp, 0, sizeof (struct blogpost));
191 bp->top_level_id = b.id;
192 Put(BLOG, (const char *)&b.id, sizeof(b.id), bp, (DeleteHashDataFunc)blogpost_destroy);
195 GetHash(BLOG, (const char *)&b.refs , sizeof(b.refs), (void *)&bp);
199 * Now we have a 'struct blogpost' to which we can add a message. It's either the
200 * blog post itself or a comment attached to it; either way, the code is the same from
204 if (bp->alloc_msgs == 0) {
205 bp->alloc_msgs = 1000;
206 bp->msgs = malloc(bp->alloc_msgs * sizeof(long));
207 memset(bp->msgs, 0, (bp->alloc_msgs * sizeof(long)) );
209 if (bp->num_msgs >= bp->alloc_msgs) {
211 bp->msgs = realloc(bp->msgs, (bp->alloc_msgs * sizeof(long)));
212 memset(&bp->msgs[bp->num_msgs], 0,
213 ((bp->alloc_msgs - bp->num_msgs) * sizeof(long)) );
215 bp->msgs[bp->num_msgs++] = Msg->msgnum;
218 syslog(LOG_DEBUG, "** comment %ld is unparented", Msg->msgnum);
226 * Sort a list of 'struct blogpost' pointers by newest-to-oldest msgnum.
227 * With big thanks to whoever wrote http://www.c.happycodings.com/Sorting_Searching/code14.html
229 static int blogview_sortfunc(const void *a, const void *b) {
230 struct blogpost * const *one = a;
231 struct blogpost * const *two = b;
233 if ( (*one)->msgs[0] > (*two)->msgs[0] ) return(-1);
234 if ( (*one)->msgs[0] < (*two)->msgs[0] ) return(+1);
240 * All blogpost entries are now in the hash list.
241 * Sort them, select the desired range, and render what we want to see.
243 int blogview_render(SharedMessageStatus *Stat, void **ViewSpecific, long oper)
245 HashList *BLOG = (HashList *) *ViewSpecific;
251 struct blogpost **blogposts = NULL;
252 int num_blogposts = 0;
253 int num_blogposts_alloc = 0;
254 int with_comments = 0;
258 /* Comments are shown if we are only viewing a single blog post */
259 if (atoi(BSTR("p"))) with_comments = 1;
261 firstp = atoi(BSTR("firstp")); /* start reading at... */
262 maxp = atoi(BSTR("maxp")); /* max posts to show... */
263 if (maxp < 1) maxp = 5; /* default; move somewhere else? */
265 /* Iterate through the hash list and copy the data pointers into an array */
266 it = GetNewHashPos(BLOG, 0);
267 while (GetNextHashPos(BLOG, it, &len, &Key, &Data)) {
268 if (num_blogposts >= num_blogposts_alloc) {
269 if (num_blogposts_alloc == 0) {
270 num_blogposts_alloc = 100;
273 num_blogposts_alloc *= 2;
275 blogposts = realloc(blogposts, (num_blogposts_alloc * sizeof (struct blogpost *)));
277 blogposts[num_blogposts++] = (struct blogpost *) Data;
281 /* Now we have our array. It is ONLY an array of pointers. The objects to
282 * which they point are still owned by the hash list.
284 if (num_blogposts > 0) {
286 /* Sort newest-to-oldest */
287 qsort(blogposts, num_blogposts, sizeof(void *), blogview_sortfunc);
289 /* allow the user to select a starting point in the list */
290 for (i=0; i<num_blogposts; ++i) {
291 if (blogposts[i]->top_level_id == firstp) {
296 /* FIXME -- allow the user (or a default setting) to select a maximum number of posts to display */
298 /* Now go through the list and render what we've got */
299 for (i=start_here; i<num_blogposts; ++i) {
300 if ((i > 0) && (i == start_here)) {
303 wc_printf("<div class=\"newer_blog_posts\"><a href=\"readfwd?go=");
304 urlescputs(ChrPtr(WC->CurRoom.name));
305 wc_printf("?firstp=%d?maxp=%d\">", blogposts[j]->top_level_id, maxp);
306 wc_printf("%s →</a></div>\n", _("Newer posts"));
308 if (i < (start_here + maxp)) {
309 blogpost_render(blogposts[i], with_comments);
311 else if (i == (start_here + maxp)) {
312 wc_printf("<div class=\"older_blog_posts\"><a href=\"readfwd?go=");
313 urlescputs(ChrPtr(WC->CurRoom.name));
314 wc_printf("?firstp=%d?maxp=%d\">", blogposts[i]->top_level_id, maxp);
315 wc_printf("← %s</a></div>\n", _("Older posts"));
319 /* Done. We are only freeing the array of pointers; the data itself
320 * will be freed along with the hash list.
329 int blogview_Cleanup(void **ViewSpecific)
331 HashList *BLOG = (HashList *) *ViewSpecific;
341 InitModule_BLOGVIEWRENDERERS
344 RegisterReadLoopHandlerset(
346 blogview_GetParamsGetServerCall,
349 blogview_LoadMsgFromServer,
353 RegisterNamespace("BLOG:PERMALINK", 0, 0, tmplput_blog_permalink, NULL, CTX_NONE);