Differences

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

punbb13:extensions:pun_pm 2009/06/03 08:50 punbb13:extensions:pun_pm 2020/02/06 11:04 current
Line 2: Line 2:
[[punbb13:extensions#Official extensions|PunBB 1.3 official extension]] [[punbb13:extensions#Official extensions|PunBB 1.3 official extension]]
  * Status: **stable**   * Status: **stable**
-  * Current version: **[[http://punbb.informer.com/extensions/pun_pm/pun_pm.zip|1.2.6]]**+  * Current version: **[[https://punbb.informer.com/extensions/pun_pm/pun_pm.zip|1.2.8]]**
===== General idea ===== ===== General idea =====
Line 11: Line 11:
==== Database ==== ==== Database ====
-New table **pun_pm_messages**+  * New table **pun_pm_messages**
^ Field ^ Type ^ Default ^ Description^ ^ Field ^ Type ^ Default ^ Description^
-| id |int(10) | | Auto-increment message ID | +| id |int(10) | | Auto-increment message ID.
-| sender_id |int(10) | 0 | The ID of the sender in **users** table | +| 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 | +| receiver_id |int(10) | NULL | The ID of the receiver in **users** table.
-| lastedited_at |int(10) | 0 | Timestamp of last editing | +| lastedited_at |int(10) | 0 | Timestamp of last editing.
-| read_at |int(10) | 0 | Timestamp of message reading |+| read_at |int(10) | 0 | Timestamp of message reading. |
| subject | varchar(255) | | | | subject | varchar(255) | | |
| body |text | | | | body |text | | |
-| status |varchar(9)| draft | One of the 'draft', 'sent', 'delivered', 'read' | +| 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_sender |tinyint(1)| 0 | 0 or 1. 1 - deleted by sender.
-| deleted_by_receiver |tinyint(1)| 0 | 0 or 1. 1 - deleted by receiver |+| deleted_by_receiver |tinyint(1)| 0 | 0 or 1. 1 - deleted by receiver. |
-Additional fields in **users** table+  * Additional fields in **users** table
^ Field ^ Type ^ Default ^ Description^ ^ Field ^ Type ^ Default ^ Description^
-|pun_pm_new_messages | INT(10) | NULL | Stores cached value of new messages | +|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 |+|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 +
-  * 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)
=== 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 63: 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 70: 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