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|}} | ||
