bgneal@75: """
bgneal@920: Signals for the forums application.
bgneal@469: 
bgneal@75: """
bgneal@469: import django.dispatch
bgneal@181: 
bgneal@75: 
bgneal@469: # This signal is sent when a topic has had its textual content (title) changed.
bgneal@469: # The provided arguments are: 
bgneal@469: #   sender - the topic model instance 
bgneal@469: #   created - True if the topic is new, False if updated
bgneal@469: 
bgneal@470: topic_content_update = django.dispatch.Signal(providing_args=['created'])
bgneal@469: 
bgneal@469: # This signal is sent when a post has had its textual content (body) changed.
bgneal@469: # The provided arguments are: 
bgneal@469: #   sender - the post model instance 
bgneal@469: #   created - True if the post is new, False if updated
bgneal@469: 
bgneal@470: post_content_update = django.dispatch.Signal(providing_args=['created'])
bgneal@469: 
bgneal@469: 
bgneal@469: def notify_new_topic(topic):
bgneal@469:     """
bgneal@469:     Sends the topic_content_update signal for a new topic instance.
bgneal@469: 
bgneal@469:     """
bgneal@470:     topic_content_update.send_robust(topic, created=True)
bgneal@469: 
bgneal@469: 
bgneal@469: def notify_updated_topic(topic):
bgneal@469:     """
bgneal@469:     Sends the topic_content_update signal for an updated topic instance.
bgneal@469: 
bgneal@469:     """
bgneal@470:     topic_content_update.send_robust(topic, created=False)
bgneal@469: 
bgneal@469: 
bgneal@469: def notify_new_post(post):
bgneal@469:     """
bgneal@469:     Sends the post_content_update signal for a new post instance.
bgneal@469: 
bgneal@469:     """
bgneal@470:     post_content_update.send_robust(post, created=True)
bgneal@469: 
bgneal@469: 
bgneal@469: def notify_updated_post(post):
bgneal@469:     """
bgneal@469:     Sends the post_content_update signal for an updated post instance.
bgneal@469: 
bgneal@469:     """
bgneal@470:     post_content_update.send_robust(post, created=False)