Differences

This shows you the differences between the selected revision and the current version of the page.

punbb13:extensions:pun_pm 2009/05/06 07:54 punbb13:extensions:pun_pm 2020/02/06 11:04 current
Line 1: Line 1:
====== Private messaging (pun_pm) ====== ====== Private messaging (pun_pm) ======
[[punbb13:extensions#Official extensions|PunBB 1.3 official extension]] [[punbb13:extensions#Official extensions|PunBB 1.3 official extension]]
-  * Current version: **[[http://punbb.informer.com/extensions/pun_pm/pun_pm.zip|1.2.6]]**+  * Status: **stable** 
 +  * Current version: **[[https://punbb.informer.com/extensions/pun_pm/pun_pm.zip|1.2.8]]**
===== General idea ===== ===== General idea =====
Line 7: Line 8:
===== Specification ===== ===== Specification =====
 +
 +==== Database ====
 +
 +  * New table **pun_pm_messages**
 +
 +^ Field ^ Type ^ Default ^ Description^
 +| id |int(10) | | Auto-increment message ID. |
 +| sender_id |int(10) |  0 | The ID of the sender in **users** table. |
 +| receiver_id |int(10) | NULL | The ID of the receiver in **users** table. |
 +| lastedited_at |int(10) |  0 | Timestamp of last editing. |
 +| read_at |int(10) |  0 | Timestamp of message reading. |
 +| subject | varchar(255) | | |
 +| body |text | | |
 +| status |varchar(9)| draft | One of the 'draft', 'sent', 'delivered', 'read'. |
 +| deleted_by_sender |tinyint(1)|  0 | 0 or 1. 1 - deleted by sender. |
 +| deleted_by_receiver |tinyint(1)|  0 | 0 or 1. 1 - deleted by receiver. |
 +
 +  * Additional fields in **users** table
 +
 +^ Field ^ Type ^ Default ^ Description^
 +|pun_pm_new_messages | int(10) | NULL | Stores the cached value of new messages. Values pun_pm_new_messages >= 0 stand for the count of unread messages. pun_pm_new_messages == -1 means that user's Inbox is full. pun_pm_new_messages == NULL means the cache has been cleared and is to be regenerated (for example, when user receives a message). |
 +|pun_pm_long_subject | tinyint(1) |  1 | 0 or 1. 1 - quote the beginning of the message in message lists. |
 +
 +  * **config** values
 +
 +^ conf_name ^ conf_value (default) ^
 +| o_pun_pm_inbox_size |  100 |
 +| o_pun_pm_outbox_size |  100 |
 +| o_pun_pm_show_new_count |  1 |
 +| o_pun_pm_show_global_link |  0 |
 +
 +==== Pages ====
 +
 +  * Administration -> Settings -> Features -> Private Messages
 +
 +^ Control ^ Type ^ Default ^
 +| Inbox limit | Text input | 100 |
 +| Outbox limit | Text input | 100 |
 +| Display 'New messages (N)' link at the top of every page | Checkbox | Yes |
 +| Put the PM Inbox link into the main navigation menu | Checkbox | No |
 +
 +  * Profile -> Settings -> Private messages
 +
 +^ Control ^ Type ^ Default ^
 +| Quote the beginning of the message in message lists | Checkbox | Yes |
 +
 +
 +  * Viewtopic -> Each post -> Author -> Send private message - Link to new message (Author as receiver)
 +  * View user's profile -> Send a private message to this user
 +  * Private Meassaging (FIXME describe in details)
 +    * Inbox
 +    * Outbox
 +    * Compose message
 +  * Every page -> Page header (near "New posts")
 +    * Link to Inbox
 +      * There are unread messages in inbox: **New messages (N)**
 +      * Else: **New messages**
 +      * No delivered message & Inbox is full: **New messages (!)**
 +  * Main navigation menu (near 'Profile') -> 'Private messages' link
 +
==== Current version ==== ==== Current version ====
=== pun_pm 1.0 === === pun_pm 1.0 ===
-  * //TODO: Update this section from old spec.// 
  * IDEA: Make "Preview" button wider to make clicking it easier.   * IDEA: Make "Preview" button wider to make clicking it easier.
-  * Option: Hot keys: <Ctrl+Enter> to send, <Ctrl+S> to save the message (JS)+  * Hot keys: <Ctrl+Enter> to send, <Ctrl+S> to save the message (JS)
  * Option: Display first words of the message next to the subject (GMail style)   * Option: Display first words of the message next to the subject (GMail style)
 +  * BBCode buttons
 +  * Display few usernames (those, who recently has written a message) next to the 'To' field. (JS)
==== Future releases ==== ==== Future releases ====
=== pun_pm 1.5 === === pun_pm 1.5 ===
 +  * Take into account if a user have post permissions on sending PM. See [[https://punbb.informer.com/forums/topic/22188/ban-certain-users-from-having-private-messages/|the Forums post]] for details.
 +  * Flood protection ([[https://punbb.informer.com/forums/post/131877/#p131877|Forum post]] for details).
  * Option: History under the quick reply form.   * Option: History under the quick reply form.
    * Show recent <N> messages from and to the corresponded user.     * Show recent <N> messages from and to the corresponded user.
    * Use JS to hide history by default and place the link (''Show history'') to show it.     * Use JS to hide history by default and place the link (''Show history'') to show it.
-  * Option: Show unread/not delivered messages number in box links (for example ''Inbox [3] | Outbox [2]''+  * Option: Show unread/not delivered messages number in box links (for example ''Inbox [ 3 ] | Outbox [ 2 ]'')
-  * Option: BBCode buttons +
-  * Admin Feature: Send PM to everyone +
-  * Option: Display few usernames (those, who recently has written a message) next to the 'To' field. (JS)+
  * Option: Quote message in the quick reply form.   * Option: Quote message in the quick reply form.
- +  * Option: Display few usernames (those, who recently has written a message) next to the 'To' field. (JS)
-Added By Utchin.+
=== pun_pm 2.0 === === pun_pm 2.0 ===
  * User option: E-mail notifications (on every message being unread for some period, or once a day)   * User option: E-mail notifications (on every message being unread for some period, or once a day)
-  * Option: [[http://punbb.informer.com/forums/post/117636/#p117636|Threads]] (messages grouped by topic) +  * Option: [[https://punbb.informer.com/forums/post/117636/#p117636|Threads]] (messages grouped by topic) 
-  * Option: [[http://punbb.ru/viewtopic.php?pid=19992#p19992|Display avatars]]+  * Option: [[https://punbb.ru/viewtopic.php?pid=19992#p19992|Display avatars]]
  * Option: 'This user is writing a letter for you'   * Option: 'This user is writing a letter for you'
  * Feature: Sort/filter messages*   * Feature: Sort/filter messages*
-  * Feature: [[http://punbb.informer.com/forums/post/119346/#p119346|Blacklist]] and [[http://punbb.informer.com/forums/post/119345/#p119345|disabling PM]]+  * Feature: [[https://punbb.informer.com/forums/post/119346/#p119346|Blacklist]] and [[https://punbb.informer.com/forums/post/119345/#p119345|disabling PM]]
=== pun_pm 3.0 === === pun_pm 3.0 ===
Line 42: Line 102:
  * When a PM is sent, a popup screen shows as you come into the website and it says something like, "You have new messages" and then have 2 buttons "See Messages" and "Go to forum"   * When a PM is sent, a popup screen shows as you come into the website and it says something like, "You have new messages" and then have 2 buttons "See Messages" and "Go to forum"
 +===== Feature request ===== 
 +  *  Add a possibility to enable or disable PM for different user groups
====== See also ====== ====== See also ======
Line 49: Line 110:
  * Trac tickets: <del>#80</del>, <del>#120</del>, <del>#161</del>, <del>#166</del>, <del>#171</del>.   * Trac tickets: <del>#80</del>, <del>#120</del>, <del>#161</del>, <del>#166</del>, <del>#171</del>.
  * Browse code:   * Browse code:
-    * Trac: [[http://punbb.informer.com/trac/browser/extensions/trunk/pun_pm/|Source]], [[http://punbb.informer.com/trac/log/extensions/trunk/pun_pm|Log]] +    * Trac: [[https://punbb.informer.com/trac/browser/extensions/trunk/pun_pm/|Source]], [[https://punbb.informer.com/trac/log/extensions/trunk/pun_pm|Log]] 
-    * SVN: [[http://punbb.informer.com/svn/extensions/trunk/pun_pm/|/svn/extensions/trunk/pun_pm/]] +    * SVN: [[https://punbb.informer.com/svn/additions/punbb-1.3/extensions/pun_pm/|/svn/additions/punbb-1.3/extensions/pun_pm/]] 
-  * Forums topic: [[http://punbb.informer.com/forums/topic/19620/extension-release-private-messaging-punpm/|[extension release] Private Messaging (pun_pm)]] +  * Forums topic: [[https://punbb.informer.com/forums/topic/19620/extension-release-private-messaging-punpm/|[extension release] Private Messaging (pun_pm)]] 
-  * Visit [[http://punbb.informer.com/extensions/|PunBB extension repository]] to download this extension.+  * Visit [[https://punbb.informer.com/extensions/|PunBB extension repository]] to download this extension. 
====== Screenshots ====== ====== Screenshots ======
-=== Form of creating new message ===+=== Compose message form ===
{{:punbb13:pun_pm.png|}} {{:punbb13:pun_pm.png|}}

Personal Tools