Class: Discorb::WelcomeScreen::Channel

Inherits:
DiscordModel show all
Defined in:
lib/discorb/guild.rb

Overview

Represents a channel to display the welcome screen.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from DiscordModel

#==, #eql?, #inspect

Constructor Details

#initialize(channel, description, emoji) -> Channel

Initialize a new welcome screen channel.

Parameters:

  • channel (Discorb::TextChannel)

    The channel to display the welcome screen.

  • description (String)

    The channel's name.

  • emoji (Discorb::Emoji)

    The emoji to display.



1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
# File 'lib/discorb/guild.rb', line 1304

def initialize(channel, description, emoji)
  if description.is_a?(Hash)
    @screen = channel
    data = description
    @channel_id = Snowflake.new(data[:channel_id])
    @description = data[:description]
    @emoji_id = Snowflake.new(data[:emoji_id])
    @emoji_name = data[:emoji_name]
  else
    @channel_id = channel.id
    @description = description
    if emoji.is_a?(UnicodeEmoji)
      @emoji_id = nil
      @emoji_name = emoji.value
    else
      @emoji_id = emoji.id
      @emoji_name = emoji.name
    end
  end
end

Instance Attribute Details

#channel -> nil, Discorb::Channel (readonly)

Note:

This method returns an object from client cache. it will return nil if the object is not in cache.

Returns:

  • (nil)

    The object wasn't cached.

  • (Discorb::Channel)

    The channel to display the welcome screen.



# File 'lib/discorb/guild.rb', line 1291

#description -> String (readonly)

Returns The channel's name.

Returns:

  • (String)

    The channel's name.



1289
1290
1291
# File 'lib/discorb/guild.rb', line 1289

def description
  @description
end

#emoji -> Discorb::Emoji (readonly)

Returns The emoji to display.

Returns:



# File 'lib/discorb/guild.rb', line 1291

Instance Method Details

#edit(enabled: Discorb::Unset, channels: Discorb::Unset, description: Discorb::Unset, reason: nil) -> Async::Task<void>

Note:

The arguments of this method are defaultly set to Discorb::Unset. Specify value to set the value, if not don't specify or specify Discorb::Unset.

Edits the welcome screen.

Parameters:

  • enabled (Boolean) (defaults to: Discorb::Unset)

    Whether the welcome screen is enabled.

  • channels (Array<Discorb::WelcomeScreen::Channel>) (defaults to: Discorb::Unset)

    The channels to display the welcome screen.

  • description (String) (defaults to: Discorb::Unset)

    The description of the welcome screen.

  • reason (String) (defaults to: nil)

    The reason for editing the welcome screen.

Returns:

  • (Async::Task<void>)

    The task.



1364
1365
1366
1367
1368
1369
1370
1371
1372
# File 'lib/discorb/guild.rb', line 1364

def edit(enabled: Discorb::Unset, channels: Discorb::Unset, description: Discorb::Unset, reason: nil)
  Async do
    payload = {}
    payload[:enabled] = enabled unless enabled == Discorb::Unset
    payload[:welcome_channels] = channels.map(&:to_hash) unless channels == Discorb::Unset
    payload[:description] = description unless description == Discorb::Unset
    @client.http.request(Route.new("/guilds/#{@guild.id}/welcome-screen", "//guilds/:guild_id/welcome-screen", :patch), payload, audit_log_reason: reason).wait
  end
end

#to_hash -> Hash

Converts the channel to a hash.

Returns:

  • (Hash)

    The hash.

See Also:



1331
1332
1333
1334
1335
1336
1337
1338
# File 'lib/discorb/guild.rb', line 1331

def to_hash
  {
    channel_id: @channel_id,
    description: @description,
    emoji_id: @emoji_id,
    emoji_name: @emoji_name,
  }
end