π Introduction
This is a Laravel package to post your content to social networks such:
- Telegram Channel (βBased on Telegram Bot API)
π Features:
π Simple. Easy to use.π Send text message to Telegram channelπ· Send photo to Telegram channelπ΅ Send audio to Telegram channelπ Send document to Telegram channelπΊ Send video to Telegram channelπ Send voice to Telegram channelπ΄ Send a group of photos or videos as an album to Telegram channelπ Send location to Telegramπ Send venue to Telegramπ Send contact to Telegram- π Send message with url inline keyboard to Telegram channel
β¨ Send text and media to Twitterπ Send text and media to Facebook
π¨ Installation:
- Download and install package via composer:
composer require toolkito/larasap
- Run the command below to publish the package config file:
config\larasap.php
php artisan vendor:publish --tag=larasap
π Configuration:
Set the social network information in the config\larasap.php
.
πΉ Usage:
First, add the use Toolkito\Larasap\SendTo;
in your controller.
Next, send message to your Telegram channel or Twitter account.
π© Roadmap
- Improve tests and coverage
- Improve performance
π± Quick examples:
β Telegram examples:
π Send text message to Telegram:
SendTo::Telegram('Hello, I\'m testing Laravel social auto posting');
π· Send photo to Telegram:
SendTo::Telegram(
'Hello, I\'m testing Laravel social auto posting', // Photo caption (Optional)
[
'type' => 'photo', // Message type (Required)
'file' => 'https://i.imgur.com/j6bzKQc.jpg' // Image url (Required)
],
'' // Inline keyboard (Optional)
);
π΅ Send audio to Telegram:
SendTo::Telegram(
'Hello, I\'m testing Laravel social auto posting', // Audio caption (Optional)
[
'type' => 'audio', // Message type (Required)
'file' => 'http://example.com/let-me-be-your-lover.mp3', // Audio url (Required)
'duration' => 208, // Duration of the audio in seconds (Optional)
'performer' => 'Enrique Iglesias', // Performer (Optional)
'title' => 'Let Me Be Your Lover' // Track name (Optional)
],
'' // Inline keyboard (Optional)
);
π Send document to Telegram:
SendTo::Telegram(
'Hello, I\'m testing Laravel social auto posting', // Document caption
[
'type' => 'document', // Message type (Required)
'file' => 'http://example.com/larasap.pdf', // Document url (Required)
],
'' // Inline keyboard (Optional)
);
πΊ Send video to Telegram:
SendTo::Telegram(
'Hello, I\'m testing Laravel social auto posting', // Video caption (Optional)
[
'type' => 'video', // Message type (Required)
'file' => 'http://example.com/let-me-be-your-lover.mp4', // Audio url (Required)
'duration' => 273, // Duration of sent video in seconds (Optional)
'width' => 1920, // Video width (Optional)
'height' => 1080 // Video height (Optional)
],
'' // Inline keyboard (Optional)
);
π Send voice to Telegram:
SendTo::Telegram(
'Hello, I\'m testing Laravel social auto posting', // Voice message caption (Optional)
[
'type' => 'voice', // Message type (Required)
'file' => 'https://upload.wikimedia.org/wikipedia/en/9/9f/Sample_of_%22Another_Day_in_Paradise%22.ogg', // Audio url (Required)
'duration' => 28 // Duration of the voice message in seconds (Optional)
],
'' // Inline keyboard (Optional)
);
π΄ Send media group to Telegram:
SendTo::Telegram(
null,
[
'type' => 'media_group', // Message type (Required)
'files' => // Array describing photos and videos to be sent, must include 2β10 items
[
[
'type' => 'photo', // Media type (Required)
'media' => 'https://i.imgur.com/j6bzKQc.jpg', // Media url (Required)
'caption' => 'Laravel sccial auto posting' // Media caption (Optional)
],
[
'type' => 'video', // Media type (Required)
'media' => 'http://example.com/let-me-be-your-lover.mp4', // Media url (Required)
'caption' => 'Let me be your lover' // Media caption (Optional)
]
]
]
);
π Send point on the map to Telegram:
SendTo::Telegram(
null,
[
'type' => 'location', // Message type (Required)
'latitude' => 36.1664345, // Latitude of the location (Required)
'longitude' => 58.8209904, // Longitude of the location (Required)
'live_period' => 86400, // Period in seconds for which the location will be updated (Optional)
'' // Inline keyboard (Optional)
);
π Send information about a venue to Telegram:
SendTo::Telegram(
null,
[
'type' => 'venue', // Message type (Required)
'latitude' => 36.166048, // Latitude of the location (Required)
'longitude' => 58.822121, // Longitude of the location (Required)
'title' => 'Khayyam', // Name of the venue (Required)
'address' => 'Neyshabur, Razavi Khorasan Province, Iran', // Address of the venue (Required)
'foursquare_id' => '', // Foursquare identifier of the venue (Optional)
'' // Inline keyboard (Optional)
);
π Send phone contacts to Telegram:
SendTo::Telegram(
null,
[
'type' => 'contact', // Message type (Required)
'phone_number' => '+12025550149', // Contact's phone number (Required)
'first_name' => 'John', // Contact's first name (Required)
'last_name' => 'Doe', // Contact's last name (Optional)
'' // Inline keyboard (Optional)
]
);
π Send message with inline button to Telegram:
SendTo::Telegram(
'Laravel social auto posting',
'',
[
[
[
'text' => 'Github',
'url' => 'https://github.com/toolkito/laravel-social-auto-posting'
]
],
[
[
'text' => 'Download',
'url' => 'https://github.com/toolkito/laravel-social-auto-posting/archive/master.zip'
],
]
]
);
Or
SendTo::Telegram(
'Laravel social auto posting',
'',
[
[
[
'text' => 'Github',
'url' => 'https://github.com/toolkito/laravel-social-auto-posting'
],
[
'text' => 'Download',
'url' => 'https://github.com/toolkito/laravel-social-auto-posting/archive/master.zip'
],
]
]
);
β Twitter examples:
β¨ Text tweet:
SendTo::Twitter('Hello, I\'m testing Laravel social auto posting');
β¨ Tweet with media:
SendTo::Twitter(
'Hello, I\'m testing Laravel social auto posting',
[
public_path('photo-1.jpg'),
public_path('photo-2.jpg')
]
);
β Facebook examples:
π Send link to Facebook page:
SendTo::Facebook(
'link',
[
'link' => 'https://github.com/toolkito/laravel-social-auto-posting',
'message' => 'Laravel social auto posting'
]
);
π Send photo to Facebook page:
SendTo::Facebook(
'photo',
[
'photo' => public_path('img/1.jpg'),
'message' => 'Laravel social auto posting'
]
);
π Send video to Facebook page:
SendTo::Facebook(
'video',
[
'video' => public_path('upload/1.mp4'),
'title' => 'Let Me Be Your Lover',
'description' => 'Let Me Be Your Lover - Enrique Iglesias'
]
);