ForgeDiscussion/forgediscussion/widgets/forum_widgets.py

#       Licensed to the Apache Software Foundation (ASF) under one
#       or more contributor license agreements.  See the NOTICE file
#       distributed with this work for additional information
#       regarding copyright ownership.  The ASF licenses this file
#       to you under the Apache License, Version 2.0 (the
#       "License"); you may not use this file except in compliance
#       with the License.  You may obtain a copy of the License at
#
#         http://www.apache.org/licenses/LICENSE-2.0
#
#       Unless required by applicable law or agreed to in writing,
#       software distributed under the License is distributed on an
#       "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
#       KIND, either express or implied.  See the License for the
#       specific language governing permissions and limitations
#       under the License.

from pylons import tmpl_context as c
from formencode import validators as fev

import ew as ew_core
import ew.jinja2_ew as ew

from allura.lib import validators as V
from allura.lib.widgets import discuss as DW
from allura.lib.widgets import form_fields as ffw
from allura.lib.widgets.forms import CsrfForm
from allura.lib.widgets.subscriptions import SubscribeForm

from forgediscussion import model as M


class _ForumSummary(ew_core.Widget):
    template = 'jinja:forgediscussion:templates/discussion_widgets/forum_summary.html'
    defaults = dict(
        ew_core.Widget.defaults,
        name=None,
        value=None,
        show_label=True,
        label=None)


class _ForumsTable(ew.TableField):

    class fields(ew_core.NameList):
        _id = ew.HiddenField(validator=V.Ming(M.ForumThread))
        num_topics = ffw.DisplayOnlyField(show_label=True, label='Topics')
        num_posts = ffw.DisplayOnlyField(show_label=True, label='Posts')
        last_post = ffw.DisplayOnlyField(show_label=True)
        subscribed = ew.Checkbox(suppress_label=True, show_label=True)
    fields.insert(0, _ForumSummary())


class ForumSubscriptionForm(CsrfForm):

    class fields(ew_core.NameList):
        forums = _ForumsTable()
        page_list = ffw.PageList()
    submit_text = 'Update Subscriptions'


class _ThreadsTable(DW._ThreadsTable):

    class fields(ew_core.NameList):
        _id = ew.HiddenField(validator=V.Ming(M.ForumThread))
        subject = ffw.DisplayOnlyField(show_label=True, label='Subject')
        url = ffw.DisplayOnlyField()
        num_replies = ffw.DisplayOnlyField(
            show_label=True, label='Num Replies')
        num_views = ffw.DisplayOnlyField(show_label=True)
        flags = ffw.DisplayOnlyField(show_label=True)
        last_post = ffw.DisplayOnlyField(show_label=True)
        subscription = ew.Checkbox(suppress_label=True, show_label=True)
    defaults = dict(DW._ThreadsTable.defaults, div_id='forum_threads')


class ThreadSubscriptionForm(DW.SubscriptionForm):

    class fields(ew_core.NameList):
        threads = _ThreadsTable()
        page_list = ffw.PageList()
        page_size = ffw.PageSize()


class AnnouncementsTable(DW._ThreadsTable):

    class fields(ew_core.NameList):
        _id = ew.HiddenField(validator=V.Ming(M.ForumThread))
        subject = ffw.DisplayOnlyField(show_label=True, label='Subject')
        url = ffw.DisplayOnlyField()
        num_replies = ffw.DisplayOnlyField(
            show_label=True, label='Num Replies')
        num_views = ffw.DisplayOnlyField(show_label=True)
        flags = ffw.DisplayOnlyField(show_label=True)
        last_post = ffw.DisplayOnlyField(show_label=True)
    defaults = dict(DW._ThreadsTable.defaults, div_id='announcements')
    name = 'announcements'


class _ForumSelector(ew.SingleSelectField):

    def options(self):
        return [
            ew.Option(label=f.name, py_value=f, html_value=f.shortname)
            for f in c.app.forums]

    def to_python(self, value, state):
        result = M.Forum.query.get(
            shortname=value, app_config_id=c.app.config._id)
        if not result:
            raise fev.Invalid('Illegal forum shortname: %s' %
                              value, value, state)
        return result

    def from_python(self, value, state):
        return value.shortname


class ModerateThread(CsrfForm):
    submit_text = 'Save Changes'

    class fields(ew_core.NameList):
        discussion = _ForumSelector(label='New Forum')
        flags = ew.CheckboxSet(options=['Sticky', 'Announcement'])

    class buttons(ew_core.NameList):
        delete = ew.SubmitButton(label='Delete Thread')


class ForumHeader(DW.DiscussionHeader):
    template = 'jinja:forgediscussion:templates/discussion_widgets/forum_header.html'
    widgets = dict(DW.DiscussionHeader.widgets,
                   announcements_table=AnnouncementsTable(),
                   forum_subscription_form=ForumSubscriptionForm())


class ThreadHeader(DW.ThreadHeader):
    template = 'jinja:forgediscussion:templates/discussion_widgets/thread_header.html'
    defaults = dict(DW.ThreadHeader.defaults,
                    show_subject=True,
                    show_moderate=True)
    widgets = dict(DW.ThreadHeader.widgets,
                   moderate_thread=ModerateThread(),
                   announcements_table=AnnouncementsTable())


class Post(DW.Post):
    show_subject = False

class Thread(DW.Thread):
    defaults = dict(
        DW.Thread.defaults,
        show_subject=False)
    widgets = dict(DW.Thread.widgets,
                   thread_header=ThreadHeader(),
                   post=Post())


class Forum(DW.Discussion):
    template = 'jinja:forgediscussion:templates/discussion_widgets/discussion.html'
    allow_create_thread = True
    show_subject = True
    widgets = dict(DW.Discussion.widgets,
                   discussion_header=ForumHeader(),
                   forum_subscription_form=ForumSubscriptionForm(),
                   whole_forum_subscription_form=SubscribeForm(),
                   subscription_form=ThreadSubscriptionForm()
                   )