LinkStack/README.md

270 lines
12 KiB
Markdown
Raw Normal View History

2022-02-23 15:37:34 +01:00
<p align="center">
2023-04-26 15:54:17 +02:00
<img width="200px" src="https://linkstack.org/wp-content/uploads/2023/04/logo-animated.svg"><br>
<picture>
<source media="(prefers-color-scheme: dark)" width="400px" srcset="https://i.imgur.com/d1mdtEw.png">
<img width="400px" src="https://i.imgur.com/pPMgaqF.png">
</picture>
2022-02-23 15:37:34 +01:00
</p>
2022-04-03 21:44:36 +02:00
2023-04-26 15:54:17 +02:00
<h3 align="center"><b>Open-Source Linktree Alternative</b></h3>
<h3 align="center">LinkStack is a highly customizable link sharing platform<br>with an intuitive, easy to use user interface.</h3>
<br>
2022-04-03 21:44:36 +02:00
2022-02-23 15:37:34 +01:00
<p align="center">
<a href="#Function">Function</a>
2022-03-21 10:00:41 +01:00
<a href="#About">About</a>
2023-04-26 15:54:17 +02:00
<a href="#Instances">Instances</a>
<a href="#Themes">Themes</a>
2022-02-23 15:37:34 +01:00
<a href="#Installation">Installation</a>
2022-06-20 16:35:00 +02:00
<a href="#Docker">Docker Version</a>
2022-02-23 15:37:34 +01:00
<a href="#Updating">Updating</a>
2022-03-22 13:04:24 +01:00
<a href="#Discord">Discord</a>
2022-02-23 15:37:34 +01:00
<a href="#Fork-Structure">Fork structure</a>
<a href="#License">License</a>
2022-05-12 12:23:02 +02:00
<a href="#Supporters">Supporters</a>
2022-02-23 15:37:34 +01:00
<a href="#Special-thanks">Special thanks</a>
<a href="#Additional-credit">Additional credit</a>
</p>
<p align="center">
2023-04-26 15:54:17 +02:00
<a href="https://github.com/linkstackorg/linkstack/stargazers"><img alt="GitHub Repo stars" src="https://img.llc.ovh/github/stars/julianprieber/littlelink-custom?label=Star%20the%20project&logo=GitHub"></a>
<a href="https://mstdn.social/@linkstack"><img alt="Mastodon Follow" src="https://img.llc.ovh/mastodon/follow/110147874401985724?domain=http%3A%2F%2Fmstdn.social&style=social"></a>
<a href="https://discord.linkstack.org"><img alt="Discord online user count" src="https://img.llc.ovh/discord/955765706111193118?color=4A55CC&label=Discord&logo=Discord&style=flat"></a>
</p>
<p align="center">
2022-10-30 18:23:11 +01:00
<a href="https://github.com/sponsors/julianprieber"><img alt="GitHub spomsors" src="https://img.llc.ovh/github/sponsors/JulianPrieber?color=BF4B8A&logo=githubsponsors&style=flat&label=Sponsor%20us%20on%20Github"></a>
<a href="https://patreon.com/julianprieber"><img alt="Patreon" src="https://img.llc.ovh/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Djulianprieber%26type%3Dpatrons&style=flat&logo=patreon"></a>
<a href="https://liberapay.com/LittleLink-Custom"><img src="https://img.llc.ovh/liberapay/patrons/LittleLink-Custom?logo=liberapay&label=LiberaPay patrons"></a>
</p>
---
2022-05-06 23:25:45 +02:00
<p align="center">
2023-04-26 15:54:17 +02:00
<a href="https://github.com/linkstackorg/linkstack/releases/latest/download/linkstack.zip"><img src="https://i.imgur.com/GZvrPEm.png" alt="Download latest" width="380" ></a>
<br>
<a href="https://github.com/linkstackorg/linkstack/releases"><img alt="GitHub release (latest by date)" src="https://img.llc.ovh/github/v/release/JulianPrieber/LittleLink-Custom?label=Latest%20release"></a>
2022-09-08 13:34:40 +02:00
</p>
2022-02-23 15:37:34 +01:00
---
2022-06-20 16:35:00 +02:00
2022-03-21 10:00:41 +01:00
## Function
2023-01-19 22:07:00 +01:00
2023-04-26 15:54:17 +02:00
LinkStack: The Ultimate Link Management Solution
2023-01-19 22:07:00 +01:00
2023-04-26 15:54:17 +02:00
LinkStack is a unique platform that provides an efficient solution for managing and sharing links online. Our platform offers a website similar to Linktree, which allows users to overcome the limitation of only being able to add one link on social media platforms.
2023-01-19 22:07:00 +01:00
2023-04-26 15:54:17 +02:00
With LinkStack, users can easily link to their own custom page and provide their followers with access to all the links they need in one convenient location. What sets LinkStack apart from other link management platforms is its flexibility, which allows users to host their links on their own web server or web hosting provider. This provides users with complete control over their online presence and ensures that their links are easily accessible.
2022-03-21 10:00:41 +01:00
2023-04-26 15:54:17 +02:00
Additionally, LinkStack allows other users to register and create their own links, making it an ideal solution for businesses and organizations looking to manage multiple links. With our user-friendly Admin Panel, managing and accessing other users' links is easy.
2022-02-23 15:37:34 +01:00
2022-03-21 10:00:41 +01:00
<br>
2022-02-23 15:37:34 +01:00
## About
2023-04-26 15:54:17 +02:00
With LinkStack, our mission is to provide users with a free and privacy-focused solution for managing and sharing links online. We believe that everyone should have access to a customizable link-sharing platform without sacrificing their privacy and control over their data.
2022-02-23 15:37:34 +01:00
2023-04-26 15:54:17 +02:00
To achieve this mission, we offer a self-hosted option for users who want complete control over their data without having it sold to third-party companies. Our platform can be easily implemented through a simple **drag and drop** process, eliminating the need for complex terminal commands or source code manipulation.
For those who may not have the technical expertise to self-host, we also offer free instances of our platform while still prioritizing their privacy. Our platform offers many of the same features and options as commercial link-sharing platforms while maintaining the values of privacy and autonomy.
Our goal is to provide a free version of a link-sharing service, similar to Linktree, while empowering users to take ownership of their data. We will never sell user data and believe in providing a trustworthy and transparent solution for managing and sharing links online.
2022-02-23 15:37:34 +01:00
<br>
2023-04-26 15:54:17 +02:00
## Instances
2022-02-23 15:37:34 +01:00
2023-04-26 15:54:17 +02:00
<h3 align="center">Find the right instance for you</h3>
<br>
<p align="center">Our community instance program provides users with the opportunity to register on hosted instances and use Linkstack for free. Members of our community have generously provided their resources to host instances, allowing us to expand the reach of Linkstack and give back to the community</h3>
<br>
2022-02-23 15:37:34 +01:00
<p align="center">
2023-04-26 15:54:17 +02:00
<a href="https://linkstack.org/instances/"><img src="https://i.imgur.com/9F3MIyL.png" alt="Community instances" width="350" ></a>
2022-02-23 15:37:34 +01:00
</p>
2023-04-26 15:54:17 +02:00
## Themes
2022-05-20 17:14:28 +02:00
<h3 align="center">Custom Themes</h3>
<br>
<p align="center">
Customize the look of your LittleLink Custom instance with themes. Themes allow you to change the look and feel of your site with a few clicks. Users can submit themes they created for everyone to download and use.
</p>
<p align="center">
Contribute by designing your own themes. You can read more about contributing below.
</p>
<br>
2023-04-26 15:54:17 +02:00
|![preview1](https://raw.githubusercontent.com/JulianPrieber/stargazer/main/preview.png) |![preview2](https://raw.githubusercontent.com/JulianPrieber/Magic-Kingdom/main/preview.png)|
2022-05-20 17:14:28 +02:00
| ------------- |-------------|
2023-04-26 15:54:17 +02:00
|![preview3](https://raw.githubusercontent.com/JulianPrieber/polygon/main/preview.png)|![preview4](https://raw.githubusercontent.com/JulianPrieber/PolySleek/main/preview.png)|
2022-05-20 17:14:28 +02:00
<br>
You can find all available Themes on here:
2023-04-26 15:54:17 +02:00
[linkstack.org/themes](https://linkstack.org/themes)
2022-05-20 17:14:28 +02:00
<br>
### How to add themes
#### How to add themes to your LittleLink Custom instance
You can add your downloaded themes to your LittleLink Custom instance on the Admin Panel. Navigate to the 'Themes' tab and scroll to the bottom of the page.
Now click on Choose file and select your downloaded theme zip file. Now click on 'Upload theme' and you should be able to select your uploaded theme now.
<br><br>
### **Themes are envisioned to be made by users for users.**
If you know a bit about CSS, consider making your own theme and adding it to the public directory.
Everything is documented in the dedicated GitHub repository.
[github.com/JulianPrieber/llc-themes/tree/main/contributing](https://github.com/JulianPrieber/llc-themes/tree/main/contributing)
2022-05-20 17:14:28 +02:00
2022-02-23 15:37:34 +01:00
## Installation
### Downloading and installing steps:
2023-04-26 15:54:17 +02:00
* **[Download](https://github.com/linkstackorg/linkstack/releases)** the latest release of LittleLink Custom and simply place the folder 'littlelink' or the contents of this folder in the root directory of your website.
2022-02-23 15:37:34 +01:00
### That's it! No coding no command line setup just plug and play.
<br>
2022-11-29 12:18:08 +01:00
#### Go through the first setup page:
2022-02-23 15:37:34 +01:00
2022-11-29 12:18:08 +01:00
When accessing your instance for the first time, you will be greeted by the first setup page.
2022-02-23 15:37:34 +01:00
2022-11-29 12:18:08 +01:00
<p align="center">
2023-04-26 15:54:17 +02:00
<img width="650" src="https://i.imgur.com/EWGy7iH.png">
2022-11-29 12:18:08 +01:00
</p>
2022-06-14 19:20:03 +02:00
2022-02-23 15:37:34 +01:00
<br>
2022-06-20 16:35:00 +02:00
## Docker
<p align="center">
2023-04-26 15:54:17 +02:00
<a href="https://github.com/JulianPrieber/llc-docker">
<picture>
<source media="(prefers-color-scheme: dark)" width="600px" srcset="https://i.imgur.com/tSHEDPv.png">
<img width="600px" src="https://i.imgur.com/0gH7UKM.png">
</picture>
</a>
2022-06-20 16:35:00 +02:00
</p>
2023-04-26 15:54:17 +02:00
The official docker version of [LittleLink Custom](https://github.com/linkstackorg/linkstack). This docker image is a simple to set up solution, containing everything you need to run LittleLink Custom.
2022-06-20 16:35:00 +02:00
2023-04-26 15:54:17 +02:00
The docker version of LittleLink Custom retains all the features and customization options of the [original version](https://github.com/linkstackorg/linkstack).
2022-06-20 16:35:00 +02:00
This docker is based on [Alpine Linux](https://www.alpinelinux.org/), a Linux distribution designed to be small, simple and secure. The web server is running [Apache2](https://www.apache.org/), a free and open-source cross-platform web server software. The docker comes with [PHP 8.0](https://www.php.net/releases/8.0/en.php) for high compatibility and performance.
#### Using the docker is as simple as pulling and deploying.
#### Pull
2023-04-26 15:54:17 +02:00
`docker pull linkstackorg/linkstack`
2022-06-20 16:35:00 +02:00
2022-06-25 23:49:03 +02:00
#### [Learn more about the Docker version](https://github.com/JulianPrieber/llc-docker)
2022-06-20 16:35:00 +02:00
<br>
2022-02-23 15:37:34 +01:00
## Updating
When a **new version** is released, you will get an update notification on your Admin Panel.
2022-06-06 17:13:52 +02:00
### Automatic one click Updater
This updater allows you to update your installation with just one click.
2022-02-23 15:37:34 +01:00
2022-06-06 17:13:52 +02:00
<br>
**How to use the Automatic Updater:**
- To update your instance, click on the update notification on your Admin Panel.
- Click on “Update automatically” and the updater will take care of the rest.
You can still download updates manually. New versions will are still uploaded to the GitHub repository as usual.
<br>
2022-02-23 15:37:34 +01:00
2022-06-06 17:13:52 +02:00
Before updating, the updater will create a backup. Your instance wont save more than two backups at a time. You can download these updates from the created folder: `backups\updater-backups`.
2022-02-23 15:37:34 +01:00
2022-06-06 17:13:52 +02:00
If you switched your database to MySQL, your database will not be included in the backup.
2022-02-23 15:37:34 +01:00
2022-03-22 13:04:24 +01:00
## Discord
<br>
<p align="center">
2023-04-26 15:54:17 +02:00
<a href="https://discord.linkstack.org"><img src="https://i.imgur.com/zRSnxjk.png" alt="Join the Discord" width="600" ></a>
2022-03-22 13:04:24 +01:00
</p>
<br>
2022-02-23 15:37:34 +01:00
## License
2023-04-26 15:54:17 +02:00
[![License: AGPL v3](https://img.llc.ovh/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
2022-02-23 15:37:34 +01:00
2022-05-12 12:23:02 +02:00
<br>
## Supporters
2023-04-26 15:54:17 +02:00
You can support LittleLink Custom [here](https://linkstack.org/sponsor).
2022-05-12 12:23:02 +02:00
**💖 Thank you:**
- Stephen Marshall
2022-11-08 00:36:50 +01:00
- [Jascha Urbach](https://github.com/jaschaurbach)
2022-08-16 14:56:05 +02:00
- [LeoColman](https://github.com/LeoColman)
2022-09-01 21:56:51 +02:00
- [Eric Chung](https://github.com/erickchung)
2022-12-31 19:02:35 +01:00
- [Daltz](https://github.com/Daltz)
- [Jan Klomp](https://github.com/escuco)
- [AnhDOS](https://github.com/AnhDOS)
2023-01-11 21:06:42 +01:00
- [MrSpuddy](https://github.com/MrSpuddy)
2022-05-12 12:23:02 +02:00
2023-04-26 15:54:17 +02:00
- [Add Your Name](https://linkstack.org/sponsor)
2022-02-23 15:37:34 +01:00
<br>
### Contributors
2022-07-29 16:41:53 +02:00
Thank you for improving LittleLink Custom!
2022-09-04 13:58:32 +02:00
<p>
2023-04-26 15:54:17 +02:00
<a href="https://github.com/linkstackorg/linkstack/graphs/contributors"><img src="https://update.littlelink-custom.com/components/contributors/" alt="Contributors" width="600" ></a>
2022-09-04 13:58:32 +02:00
</p>
<br>
2022-07-29 20:31:48 +02:00
### Beta Testers
2022-07-29 22:43:30 +02:00
Thank you for all your efforts!
2022-07-29 20:31:48 +02:00
2022-09-04 13:58:32 +02:00
<p>
2023-04-26 15:54:17 +02:00
<a href="https://linkstack.org/beta-tester"><img src="https://update.littlelink-custom.com/components/beta-testers/" alt="Contributors" width="600" ></a>
2022-09-04 13:58:32 +02:00
</p>
2022-07-29 20:31:48 +02:00
2023-04-26 15:54:17 +02:00
[Become a beta tester](https://linkstack.org/beta-tester)
2022-07-29 20:31:48 +02:00
<br>
2022-02-23 15:37:34 +01:00
## Additional-credit
- [laravel](https://github.com/laravel/laravel)
2023-04-26 15:54:17 +02:00
- [forked from](https://github.com/khzg/littlelink-admin)
- [default theme](https://github.com/sethcottle/littlelink)
- [dashboard template](https://github.com/iqonicdesignofficial/hope-ui-laravel-dashboard)
2022-02-23 15:37:34 +01:00
- [general animations](https://github.com/animate-css/animate.css)
2022-03-16 14:54:09 +01:00
- [config editor](https://github.com/GeoSot/Laravel-EnvEditor)
2023-04-26 15:54:17 +02:00
- [text editor (admin)](https://github.com/ckeditor/ckeditor4)
- [text editor (user)](https://github.com/ckeditor/ckeditor5)
2022-05-27 16:52:24 +02:00
- [updater backend](https://github.com/codedge/laravel-selfupdater)
2022-05-27 16:56:00 +02:00
- [backup backend](https://github.com/spatie/laravel-backup)