Module: RedditKit::Client::PrivateMessages

Included in:
RedditKit::Client
Defined in:
lib/redditkit/client/private_messages.rb

Overview

Methods for retrieving and sending private messages.

Instance Method Summary collapse

Instance Method Details

#block_author_of_message(message) ⇒ Object

Blocks the author of a private message or comment. Users cannot be blocked based on username as reddit only allows you to block those who have harassed you (thus leaving a message in your inbox).



59
60
61
62
 
# File 'lib/redditkit/client/private_messages.rb', line 59

def block_author_of_message(message)
  parameters = { :id => extract_full_name(message) }
  post('api/block', parameters)
end

#mark_as_read(message) ⇒ Object

Marks a message as read.



42
43
44
45
 
# File 'lib/redditkit/client/private_messages.rb', line 42

def mark_as_read(message)
  parameters = { :id => extract_full_name(message) }
  post('api/read_message', parameters)
end

#mark_as_unread(message) ⇒ Object

Marks a message as unread.



50
51
52
53
 
# File 'lib/redditkit/client/private_messages.rb', line 50

def mark_as_unread(message)
  parameters = { :id => extract_full_name(message) }
  post('api/unread_message', parameters)
end

#messages(options = {}) ⇒ RedditKit::PaginatedResponse

Gets the current user’s private messages or comment replies.

Options Hash (options):

  • :category (inbox, unread, sent, messages, mentions, moderator, comments, selfreply) —

    The category from which to return messages.

  • :limit (1..100) —

    The number of messages to return.

  • :before (String) —

    Only return subreddits before this id.

  • :after (String) —

    Only return subreddits after this id.

  • :mark (Boolean) —

    Whether to mark requested messages as read.



17
18
19
20
21
22
23
 
# File 'lib/redditkit/client/private_messages.rb', line 17

def messages(options = {})
  category = options[:category] || 'inbox'
  path = "message/#{category}.json"
  options.delete :category

  objects_from_response(:get, path, options)
end

#send_message(message, recipient, options = {}) ⇒ Object

Send a message to another reddit user.

Options Hash (options):

  • :subject (String) —

    The subject of the message.

  • :captcha_identifier (String) —

    A CAPTCHA identifier to send with the message, if the current user is required to fill one out.

  • :captcha_value (String) —

    The value of the CAPTCHA to send with the message, if the current user is required to fill one out.



32
33
34
35
36
37
 
# File 'lib/redditkit/client/private_messages.rb', line 32

def send_message(message, recipient, options = {})
  username = extract_string(recipient, :username)
  parameters = { :to => username, :text => message, :subject => options[:subject], :captcha => options[:captcha_value], :iden => options[:captcha_identifier] }

  post('api/compose', parameters)
end

#unblock(user) ⇒ Object

Unblocks a user.



67
68
69
70
 
# File 'lib/redditkit/client/private_messages.rb', line 67

def unblock(user)
  enemy_name = extract_string(user, :username)
  friend_request 'unfriend', :container => current_user.full_name, :name => enemy_name, :type => :enemy
end