Download the PHP package svenpetersen/instagram without Composer
On this page you can find all versions of the php package svenpetersen/instagram. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package instagram
TYPO3 Extension "instagram"
What does it do?
TYPO3 Extension to import and display instagram posts/feeds in a TYPO3 Website.
Creates and auto-refreshes long-lived api access tokens, imports instagram feeds/posts as entities to the database and output feeds/posts via Frontend-Plugin.
Summary of features
- Backend module for easy creation of long-lived API access tokens
- Automatic refreshing of API access tokens to keep them valid
- Import multiple Instagram users feeds/posts
- Uses official Instagram-API to access a users feed.
- Provides commands to refresh access tokens and to import feeds via cronjob/scheduler
- Downloads the posts (images/videos). No API calls needed when displaying them = no frontend performance impact.
- Display users feeds/posts in any way you like
- Based on Extbase and Fluid
Installation
The recommended way to install the extension is by using Composer. In your Composer based TYPO3 project root, just do:
composer require svenpetersen/instagram
Setup
- Include the provided static TypoScript
- Create a Facebook "Instagram Basic Display" App: See the official Documentation for a step by step guide
- Use the Backend Module provided by this Extension to create a "long-lived access token" in a "Feed" Entity.
- Execute the command
instagram:import:posts {username} {storagePid} [limit|25]to import the posts from a given users feed - Add a Frontend-Plugin on a page to output the imported posts in the frontend.
Recommended:
- Add a cronjob/scheduler task to refresh the API Access tokens automatically - see "Automatic Access Token refresh" for details.
- Add a cronjob/scheduler task to import the posts on a regular basis
Compatibility
| Version | TYPO3 | PHP | Support/Development |
|---|---|---|---|
| 2.x | 12.4 | >= 8.1 <= 8.2 | Features, Bugfixes, Security Updates |
| 1.x | 10.4 - 11.5 | 7.4 - 8.0️ | Bugfixes, Security Updates |
Funtionalities
Automatic import of posts
This extension comes with a command to import (new) posts of a given instagram user. It is recommended to set this command up to run regularly - e.g. once a day.
instagram:import:posts {username} {storagePid} [limit|25] [--since="01/01/2022 00:00:00" --until="12/31/2022 23:59:59"
]
Arguments:
| Name | Description |
|---|---|
| username | The instagram username to import posts for |
| storagePid | The PID to save the imported posts |
| limit | The maximum number of posts to import (Optional. Default: 25) |
Options:
| Name | Description |
|---|---|
| --since | Date string to fetch posts since (Format: "MM/DD/YYYY H:i:s"). |
| --until | Date string to fetch posts until (Format: "MM/DD/YYYY H:i:s"). |
Automatic Access Token Refreshing
The generated long-lived access token is valid for 60 days. It can be refreshed when at least 24 hours old.
To handle automatic refreshing of your access tokens this extension provides the command
instagram:accesstoken:refresh-all
Make sure to run this command regularly - e.g. once a day via a cronjob/scheduler - in order to keep your access token valid.
Disable/enable Backend module "Token Generator"
To disable the Backend module - e.g. after you generated all needed tokens - add
this
line to the LocalConfiguration.php/AdditionalConfiguration.php:
$GLOBALS['TYPO3_CONF_VARS']['SYS']['features']['instagram.tokenGeneratorBeModule'] = false;
Extending
Additional Template Selector
If you need a kind of template selector inside a plugin, you can add your own selections by adding those to:
$GLOBALS['TYPO3_CONF_VARS']['EXT']['instagram']['templateLayouts']['myext'] = ['My Title', 'my value'];
Local path to save downloaded files
By default all images/videos in imported posts are saved in
/public/fileadmin/instagram
You can change this path via the Extensions settings
local_file_storage_path option.
Events
This extension comes with a few events for you to listen to and add your own logic:
| Name | Args. | Description | |
|---|---|---|---|
| PrePersistPostEvent | Post $post string $action['new' or ‘update'] |
Dispatched before a Post is saved. Can be used to modify the Post entity. | Dispatched before the view is rendered. Can be used to modify the view object. E.g. adding additional vars to the frontend (e.g. pagination) |
| PostPersistPostEvent | Post $post | Dispatched after a Post is saved. | Dispatched before the view is rendered. Can be used to modify the view object. E.g. adding additional vars to the frontend (e.g. pagination) |
Contributing
Please refer to the contributing document included in this repository.
Testing
This Extension comes with a testsuite for coding styles and unit/functional tests. To run the tests simply use the provided composer script:
composer ci:test
All versions of instagram with dependencies
psr/http-factory Version ^1.0
symfony/console Version >=5.0
typo3/cms-core Version ^12.4
typo3/cms-extbase Version ^12.4