gkaklas/littlelink-extended
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Updates

Browse source 
Adds Babylist as a new brand, fixes SimpleX Chat Alt, and adds a new sensitive content warning module (new HTML, new CSS file, new JS folder and file, new icon).
This commit is contained in:
Seth Cottle 2025-03-16 20:59:47 -04:00
parent 98bf64ff42
commit c99d8fd702
8 changed files with 297 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

140
README.md
View file

@ -2,33 +2,143 @@
![Logo](https://cdn.cottle.cloud/GitHub/LittleLink/littlelink.gif)
LittleLink Extended is an addon repository for [LittleLink](https://github.com/sethcottle/littlelink). This repository welcomes more niche services that aren't as globally or regionally popular as required by the core LittleLink repo. Users will be able to import the entirety of these extensions into their fork of LittleLink or selectively add services from it by copy and pasting what they'd like to use into their `brands.css` file and `icons` folders.
**LittleLink Extended** is an add-on repository for [LittleLink](https://github.com/sethcottle/littlelink). It welcomes more niche or region-specific services that aren’t quite popular enough for the core LittleLink repo. By importing this extension, you can expand your LittleLink setup with additional brands and icons. You can either import everything or selectively copy only the pieces you need.
### 📂 Getting Started
---
You will need to fork or download a copy of the original [LittleLink project](https://github.com/sethcottle/littlelink) to use these extended brands in tandem with.
## 📂 Getting Started
#### ⬇️ Import the Extended CSS
To use **LittleLink Extended**, you’ll need a copy of the original [LittleLink project](https://github.com/sethcottle/littlelink). Fork or download that repository first.
Copy and paste the `brands-extended.css` file that is in the `css` folder of this repository into the `css` folder that is in your copy of the [LittleLink project](https://github.com/sethcottle/littlelink). Your folder should look a little something like this after:
Then:
![Extended Brands CSS](https://cdn.cottle.cloud/littlelink/brands-extended-folder.png)
1. **Clone or download** this **LittleLink Extended** repo.
2. **Copy the necessary files** (CSS and icons) into your LittleLink project.
3. **Reference the new CSS** in your `index.html`.
#### ⬇️ Import the Extended Icons
### 1. Import the Extended CSS
Copy and paste the `icons-extended` folder that is in the `images` folder of this repository into the `images` folder in your copy of the [LittleLink project](https://github.com/sethcottle/littlelink). Your folder should look a little something like this after:
In this repo’s `css` folder, you’ll find **`brands-extended.css`**. Copy that file into the `css` folder of your LittleLink project. Your folder structure should look something like this afterward:
![Extended Brands Icons](https://cdn.cottle.cloud/littlelink/icons-extended-folder.png)
```
littlelink
│
├── css
│ ├── reset.css
│ ├── style.css
│ ├── brands.css
│ └── brands-extended.css ← (new)
│
└── images
└── icons
```
When access iconography, you'll reference the folder `images/icons-extended/...` to refence the icons included with LittleLink Extended.
### 2. Import the Extended Icons
#### ✏️ Edit `index.html` to include the Extended CSS
In this repo’s `images` folder, you’ll find a folder named **`icons-extended`**. Copy that entire folder into the `images` folder of your LittleLink project. Your structure might then look like:
Open `index.html` in your copy of the [LittleLink project](https://github.com/sethcottle/littlelink), the first section of the HTML has a `<head>` section. Find the CSS segment `<link rel="stylesheet" href="css/brands.css">` and underneath it, add `<link rel="stylesheet" href="css/brands-extended.css">`. It should look something like this:
```
littlelink
│
├── css
│ ├── ...
├── images
│ ├── avatar.png
│ ├── icons
│ └── icons-extended ← (new)
└── ...
```
When you need to reference an extended icon, you’ll do so via `images/icons-extended/...`.
![CSS Preview](https://cdn.cottle.cloud/GitHub/LittleLink/css.png)
### 3. Edit `index.html` to Include the Extended CSS
### 👍 That's it!
Open your LittleLink project’s `index.html`. In the `<head>` section, find the line that references `brands.css`:
View the original [LittleLink repo](https://github.com/sethcottle/littlelink).
```html
<link rel="stylesheet" href="css/brands.css">
```
Beneath it, add a line for the extended CSS:
```html
<link rel="stylesheet" href="css/brands-extended.css">
```
It should look something like:
```html
<link rel="stylesheet" href="css/reset.css">
<link rel="stylesheet" href="css/style.css">
<link rel="stylesheet" href="css/brands.css">
<link rel="stylesheet" href="css/brands-extended.css">
```
That’s all you need to pull in the extended brand styles.
---
## 👍 That’s It!
At this point, you’ve successfully imported **LittleLink Extended**. To see how to use the newly added buttons, simply reference them in your `index.html` or `preview.html` by using their associated classes (e.g., `button-anilist`, `button-bereal`, etc.).
For more information on the original LittleLink project, check out the [LittleLink repo](https://github.com/sethcottle/littlelink).
---
# Extended Modules
## Sensitive Content Warning
In addition to extended brands, this repository includes an **optional module** for adding **“Sensitive Content”** warnings. This module lets you display a slide-down panel warning users about potentially sensitive or age-restricted content. Each panel can include a **“Continue”** button that opens a custom link, set entirely in your HTML.
<img
src="https://cdn.cottle.cloud/GitHub/LittleLink/sensitive-content-warning.gif"
alt="Sensitive Content Warning"
width="50%"
/>
### How It Works
1. **Copy the CSS**
Download `sensitive-content.css` from this repo (in the `css` folder) and place it in your LittleLink project’s `css` folder. You can adjust the button color that is declared in `sensitive-content.css` or use a button color style from `brands.css` or `brands-extended.css` to adjust the button to any styling of your choice.
2. **Copy the JS**
Download `js` folder which contains `sensitive-content.js` from this repo and place it in your LittleLink project. By default LittleLink doesn't use any JS.
3. **Reference Them**
In your `index.html` (or `preview.html` in LittleLink Extended), add the CSS after your main styles:
```html
<link rel="stylesheet" href="css/style.css">
<link rel="stylesheet" href="css/brands-extended.css">
<link rel="stylesheet" href="css/sensitive-content.css"> <!-- new -->
```
Then load the JS near the bottom of `<body>`:
```html
<script src="js/sensitive-content.js"></script>
```
4. **Add the HTML Snippet**
Wherever you want a “Sensitive Content” button, insert:
```html
<div class="slide-container" data-continue-url="https://example.com">
<a class="button button-default sensitive-trigger" href="javascript:void(0)">
<img class="icon" aria-hidden="true" src="images/icons/generic-warning.svg" alt="Warning Icon">
Sensitive Content
</a>
<div class="sensitive-panel">
<div class="sensitive-panel__content">
<p>This link may contain content that is not appropriate for all audiences.</p>
<button class="button button-default sensitive-continue">Continue</button>
</div>
</div>
</div>
```
- **`data-continue-url="..."`** sets the external link for the “Continue” button.
- **`.sensitive-trigger`** toggles the panel open/close.
- **`.sensitive-panel`** is the collapsible container.
- **`.sensitive-continue`** triggers navigation to the `data-continue-url`.
### Multiple Sensitive Content Panels
You can add **multiple** sensitive content panels by repeating the snippet above with different `data-continue-url` values. The JS automatically handles each one independently, so each panel can open a different link.