Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/happytodev/filament-social-networks
Filament plugin to set and display your social networks on your website
https://github.com/happytodev/filament-social-networks
laravel social-network
Last synced: 3 months ago
JSON representation
Filament plugin to set and display your social networks on your website
- Host: GitHub
- URL: https://github.com/happytodev/filament-social-networks
- Owner: happytodev
- License: mit
- Created: 2022-06-26T09:43:16.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-09T02:16:18.000Z (over 1 year ago)
- Last Synced: 2024-06-06T11:44:19.429Z (8 months ago)
- Topics: laravel, social-network
- Language: PHP
- Homepage:
- Size: 86.9 KB
- Stars: 7
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
[
](https://supportukrainenow.org)
# Filament plugin to set and display your social networks icons on your website
[](https://packagist.org/packages/happytodev/filament-social-networks)
[](https://github.com/happytodev/filament-social-networks/actions?query=workflow%3Arun-tests+branch%3Amain)
[](https://github.com/happytodev/filament-social-networks/actions?query=workflow%3A"Check+%26+fix+styling"+branch%3Amain)
[](https://packagist.org/packages/happytodev/filament-social-networks)
This is a filamentphp plugin. It helps you to define the social networks you use in the filament backend, and display it on your website using Blade component provided.
_Display your social networks on your front with the help of Blade component provided in this plugin_
_List of all of your social networks_
_Detail of one of your social network_
## Functionnalities
- possibility to add, modify, delete, list social networks among the following 21 :
- DeviantArt
- Discord
- Facebook
- Github
- Instagram
- LinkedIn
- Medium
- Pinterest
- Reddit
- Skype
- Snapchat
- Soundcloud
- Telegram
- TikTok
- Tumblr
- Twitch
- Twitter
- Vimeo
- WattPad
- WhatsApp
- Youtube
- easy to install as Filament plugin (see below)
- possibility to use OrbitPHP or classical driver database
- social networks icons provided by default via svgporn
- possibility to add your custom icons if you want
- possibility to activate or not a social network
- by default link open in a new tab (target='_blank')
## On the roadmap
- [x] add more social networks
- [ ] improve form appearance
- [ ] deactivate already selected social network
- [ ] provide more Blade component to display on front
- [ ] add localization
- [x] add possibility to search the social network in the list
- if you have an idea of improvment, let me know !
## Support us
If you want and if you can, you can [sponsorship](https://github.com/sponsors/happytodev) this project.
It will help me a lot ;-)
## Installation
You can install the package via composer:
```bash
composer require happytodev/filament-social-networks
```
### Database
#### Using filament-social-networks with Filament and Orbit driver
If you use Orbit as database driver, there is no migrations to launch.
Instead, you have to :
- install Orbit
```bash
composer require ryangjchandler/orbit
```
- publish model file directly by using :
```bash
php artisan vendor:publish --tag="filament-social-networks-model-with-orbit"
```
### Using filament-social-networks with classical database drivers
You have to publish and run the migrations with:
```bash
php artisan vendor:publish --tag="filament-social-networks-migrations"
php artisan migrate
```
- publish model file directly by using :
```bash
php artisan vendor:publish --tag="filament-social-networks-model-classical"
```
### Others publishable files
To use default picture for Social Network, you have to publish assets :
```bash
php artisan vendor:publish --tag="filament-social-networks-assets"
```
Optionnaly, you can publish the config file with:
```bash
php artisan vendor:publish --tag="filament-social-networks-config"
```
This is the contents of the published config file:
```php
return [
];
```
Optionally, you can publish the views using
```bash
php artisan vendor:publish --tag="filament-social-networks-views"
```
## Usage
Connect to your Filament dashboard.
You will see a new entry in the menu `Social Networks`
By clicking on the 'New social network' button (in the top right corner), you can add a new group of social networks.
You have to give it a name that you need after to display it.
You can, also, decide to let it inactive for the moment.
In that group, you can add every available social networks.
You can order them simply by drag and drop.
Every social network added to a group can be active (by default) or inactive.
You can collapse one, many or all Social Networks you've set if you need
Don't forget to save when you are satisfied by your social network group.
When you're satisfied, you can use everywhere you want the Blade component provided by this plugin in your template file :
```php
```
Et voilà !
## Testing
```bash
composer test
```
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.
## Security Vulnerabilities
Please review [our security policy](../../security/policy) on how to report security vulnerabilities.
## Credits
- [Frédéric Blanc](https://github.com/happytodev)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.