J4asper.DSharpPlus.BetterPagination 1.0.1

BetterPagination

This NuGet package provides an enhanced pagination experience for DSharpPlus, offering a better visual interface for navigating between paginated content.

• Installation
  • NuGet
  • From Source
• Documentation
  • Example Usage

Installation

NuGet

To install the package, open the terminal in your project and run the following command, replacing 1.0.0 with the latest version:

dotnet add package J4asper.DSharpPlus.BetterPagination --version 1.0.0

Alternatively, you can search for J4asper.DSharpPlus.BetterPagination in your IDE’s NuGet Package Manager.

From Source

To build the package from source, follow these steps:

1. Clone the repository:

   git clone https://github.com/j4asper/DSharpPlus.BetterPagination.git
   
   

2. In your project’s .csproj file, add the following reference:

   <ProjectReference Include="../DSharpPlus.BetterPagination/DSharpPlus.BetterPagination/DSharpPlus.BetterPagination.csproj" />
   
   

Documentation

This package adds an extension method, SendBetterPaginatedMessageAsync, to the SlashCommandContext class, enabling easy pagination in your bot commands.

Example Usage

Here’s an example of how to use the package to send a paginated message within a command:

[Command("example")]
[Description("This is a paginated example command")]
public async ValueTask PaginatedExampleCommand(SlashCommandContext context)
{
    var embedPageOne = new DiscordEmbedBuilder()
        .WithDefaultColor()
        .WithContent("This is page 1");

    var embedPageTwo = new DiscordEmbedBuilder()
        .WithDefaultColor()
        .WithContent("This is page 2");

    List<Page> pages = new()
    {
        new Page { Embed = embedPageOne },
        new Page { Embed = embedPageTwo }
    };

    // Send the paginated message
    await context.SendBetterPaginatedMessageAsync(pages);
}

In this example:

• Two pages are created using DiscordEmbedBuilder, each with different content.
• These pages are added to a List<Page>, which is passed to the SendBetterPaginatedMessageAsync method to send a paginated message.
• Users can navigate between pages using the forward and back buttons that are automatically added to the message.