Download the PHP package hitmare/unlockptb without Composer

unlockPTB

Table of Contents

• Introduction
• Instructions
  • Installation
  • Add the Lockstatus Check to your Files
  • How to use
  • Aviable Commands
    • Installation of the Commands

Introduction

This is unlock Class for the PHP Telegram Bot Libary to lock an unlock the Bot in Private and Group Channels

Instructions

Installation

Install this package through [Composer][composer]. Edit your project's composer.json file to require hitmare/unlockptb.

Edit composer.json file and add hitmare/unlockptb under require

and run composer update

or

run this command in your command line:

• Then you have to import the chat_unlock.sql file into your existend Telegram Database

• Add the following into the hook.php where $telegram->setCommandConfig is located

You also have to add for every Command what you want to lock a CommandConfig line in the hook.php
eg

Add the Lockstatus Check to your Files

To use the Libary you have to add the Code for checking the Lockstatus in every Command File where you want to include the Lock function. At the Moment it is, as far as i know, the only way to implement this without editing the Main Code of the Bot

• Add the required Namespace

• Add the Lockstatus Check as first inside the execute() funciton

To define in wich Type of Chat the Lock should applys, just add or delete the Chat type in the hoop.php

The Lock applys to every Chat that matches the type of the Array above.

How to use

1. Generate the Authkey

To generate the Authkey there are two ways:
Get the wanted Chat or User ID through the /chats * Command and execute /getAutchkey <id> directly to the Bot

OR

(Only for Group Chats) Execute /getAutchkey inside of the Group Chat and the Bot will send the Botadmin who send the Command the Authkey

2. Unlock the Bot For Private Chat:
   • Execute /unlock <Authkey> and the Bot will be unlocked. For Group Chats:
   • Execute /unlock <Authkey> as an Bot Admin or as an Channel Owner and the Bot will be unlocked.

To Lock the Bot execute /lock. In Group Chats only the Bot Admin and the Group Chat Owner can use it
To Show the Lockstatus execute /lockstatus. In Group Chats only the Bot Admin and the Group Chat Owner can use it

Aviable Commands

This Library includes four (4) Commands

• /getAuthkey - Generates the Unlock Authkey. Can only be used from Bot Admin
• /unlock - Unlocks the Bot. In Group Chats only the Bot Admin and the Group Chat Owner can use it
• /lock - Locks the Bot. In Group Chats only the Bot Admin and the Group Chat Owner can use it
• /lockstatus - Shows the Lockstatus of the Bot. In Group Chats only the Bot Admin and the Group Chat Owner can use it

Installation of the Commands

You can copy all four Commands into your custom Command folder or add the following path to your custom Command array inside of your hook.php to stay up to date with your Commandfiles

/vendor/hitmare/unlockptb/Commands/

eg:

$commands_path = [
__DIR__ . '/Commands/',
__DIR__ . '/vendor/hitmare/unlockptb/Commands/',
];