Skip to content

Commit 5368102

Browse files
authored
Extension (#5)
* Add Extension
1 parent 4cffdc9 commit 5368102

File tree

7 files changed

+147
-2
lines changed

7 files changed

+147
-2
lines changed

_config.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,9 @@ author: Shane/Ralph
55
site_name: Django Files
66
site_url: https://django-files.github.io/
77
github_url: https://github.com/django-files/django-files
8+
9+
chrome_url: https://chromewebstore.google.com/detail/django-files/abpbiefojfkekhkjnpakpekkpeibnjej
10+
firefox_url: https://addons.mozilla.org/en-US/firefox/addon/django-files/
11+
chrome_id: abpbiefojfkekhkjnpakpekkpeibnjej
12+
firefox_id: django-files
13+
github_name: django-files/web-extension

_layouts/default.html

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,8 @@
5454
Home</a></li>
5555
<li class="nav-item"><a class="nav-link {% if page.title == 'Docs' %}active{% endif %}" href="/docs/">
5656
Docs</a></li>
57+
<li class="nav-item"><a class="nav-link {% if page.title == 'Web Extension' %}active{% endif %}" href="/extension/">
58+
Web Extension</a></li>
5759
<li class="nav-item"><a class="nav-link" href="/screenshots/" target="_blank">
5860
Screen Shots <i class="fa-solid fa-arrow-up-right-from-square"></i></a></li>
5961
<li class="nav-item"><a class="nav-link" href="{{ site.github_url }}" target="_blank" rel="noopener">
@@ -72,16 +74,18 @@
7274
<footer class="footer mt-auto p-2 flex-shrink-0">
7375
<div class="container-fluid">
7476
<div class="row">
75-
<div class="col-12 col-sm-4">
77+
<div class="col-12 col-md-4">
7678
<p><a class="link-body-emphasis text-decoration-none" href="{{ site.github_url }}#readme" target="_blank" rel="noopener">
7779
<i class="fab fa-github"></i> {{ site.site_name }}</a></p>
7880
</div>
79-
<div class="col-12 col-sm-8 text-sm-end">
81+
<div class="col-12 col-md-8 text-md-end">
8082
<ul class="list-inline">
8183
<li class="list-inline-item"><a class="link-body-emphasis text-decoration-none {% if page.title == 'Home' %}fw-bold{% endif %}" href="/">Home</a></li>
8284
<li class="list-inline-item">|</li>
8385
<li class="list-inline-item"><a class="link-body-emphasis text-decoration-none {% if page.title == 'Docs' %}fw-bold{% endif %}" href="/docs/">Docs</a></li>
8486
<li class="list-inline-item">|</li>
87+
<li class="list-inline-item"><a class="link-body-emphasis text-decoration-none {% if page.title == 'Web Extension' %}fw-bold{% endif %}" href="/docs/">Extension</a></li>
88+
<li class="list-inline-item">|</li>
8589
<li class="list-inline-item"><a class="link-body-emphasis text-decoration-none" href="/screenshots/" target="_blank">Screen Shots <i class="fa-solid fa-arrow-up-right-from-square"></i></a></li>
8690
</ul>
8791
</div>

extension.html

Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
---
2+
permalink: /extension/
3+
layout: default
4+
title: Web Extension
5+
description: Django Files Chrome Web Extension and Firefox Browser Addon.
6+
---
7+
8+
<h1>{{ site.site_name }} - {{ page.title }}</h1>
9+
10+
<div class="mb-2" style="min-height: 20px;">
11+
<a href="{{ site.chrome_url }}" rel="nofollow" target="_blank">
12+
<img src="https://img.shields.io/chrome-web-store/users/{{ site.chrome_id }}?logo=google&logoColor=white&label=google%20users" alt="Chrome Web Store Users" style="max-width: 100%;"></a>
13+
<a href="{{ site.firefox_url }}" rel="nofollow" target="_blank">
14+
<img src="https://img.shields.io/amo/users/{{ site.firefox_id }}?logo=mozilla&label=mozilla%20users" alt="Mozilla Add-on Users" style="max-width: 100%;"></a>
15+
<img src="https://img.shields.io/chrome-web-store/v/{{ site.chrome_id }}?label=chrome&logo=googlechrome" alt="Chrome Web Store Version" style="max-width: 100%;"></a>
16+
<a href="{{ site.firefox_url }}" rel="nofollow" target="_blank">
17+
<img src="https://img.shields.io/amo/v/{{ site.firefox_id }}?label=firefox&logo=firefox" alt="Mozilla Add-on Version" style="max-width: 100%;"></a>
18+
<a href="{{ site.github_url }}/releases/latest" rel="nofollow" target="_blank">
19+
<img src="https://img.shields.io/github/v/release/{{ site.github_name }}?logo=github" alt="GitHub Release Version" style="max-width: 100%;"></a>
20+
<a href="{{ site.github_url }}/blob/master/manifest.json" rel="nofollow" target="_blank">
21+
<img src="https://img.shields.io/github/manifest-json/v/{{ site.github_name }}?filename=manifest.json&logo=json&label=manifest" alt="Manifest Version" style="max-width: 100%;"></a>
22+
</div>
23+
24+
<p class="lead">
25+
Modern Chrome Web Extension and Firefox Browser Addon for Django Files to view recent uploads, shorten URLs, and upload Images, Video or Audio files with a right click.
26+
</p>
27+
28+
<div class="ms-1 mb-3">
29+
<a href="{{ site.chrome_url }}" target="_blank">
30+
<img alt="Chrome" src="https://github.com/alrra/browser-logos/main/src/chrome/chrome_48x48.png" width="42" height="42" /></a>
31+
<a href="{{ site.firefox_url }}" target="_blank">
32+
<img alt="Firefox" src="https://github.com/alrra/browser-logos/main/src/firefox/firefox_48x48.png" width="42" height="42" /></a>
33+
<a href="{{ site.chrome_url }}" target="_blank">
34+
<img alt="Edge" src="https://github.com/alrra/browser-logos/main/src/edge/edge_48x48.png" width="42" height="42" /></a>
35+
<a href="{{ site.chrome_url }}" target="_blank">
36+
<img alt="Chromium" src="https://github.com/alrra/browser-logos/main/src/chromium/chromium_48x48.png" width="42" height="42" /></a>
37+
<a href="{{ site.chrome_url }}" target="_blank">
38+
<img alt="Opera" src="https://github.com/alrra/browser-logos/main/src/opera/opera_48x48.png" width="42" height="42" /></a>
39+
<a href="{{ site.chrome_url }}" target="_blank">
40+
<img alt="Brave" src="https://github.com/alrra/browser-logos/main/src/brave/brave_48x48.png" width="42" height="42" /></a>
41+
<a href="{{ site.chrome_url }}" target="_blank">
42+
<img alt="Vivaldi" src="https://github.com/alrra/browser-logos/main/src/vivaldi/vivaldi_48x48.png" width="42" height="42" /></a>
43+
</div>
44+
45+
<ul>
46+
<li>View Recent Uploads on Popup</li>
47+
<li>Preview Popup Images on Hover.</li>
48+
<li>Right Click any Image, Video, or Audio to Upload.</li>
49+
<li>Right Click any URL to Shorten.</li>
50+
<li>Automatically Auth with Django Files.</li>
51+
<li>Automatic Dark/Light Mode based on Browser Settings.</li>
52+
</ul>
53+
54+
<div class="mb-2">
55+
<img src="/images/extension/popup.jpg" class="img-thumbnail" alt="Chrome Pin Extension" width="380">
56+
</div>
57+
58+
<h2>Install</h2>
59+
60+
<p class="ms-3">
61+
<i class="fa-brands fa-chrome me-1"></i>
62+
<a href="{{ site.chrome_url }}" target="_blank">Google Chrome Web Store</a>
63+
<br>
64+
<i class="fa-brands fa-firefox-browser me-1"></i>
65+
<a href="{{ site.firefox_url }}" target="_blank">Mozilla Firefox Add-ons</a>
66+
</p>
67+
68+
<p>
69+
All <strong>Chromium</strong> Based Browsers can install the extension from the
70+
<a href="{{ site.chrome_url }}" target="_blank">Chrome Web Store</a>.
71+
</p>
72+
73+
<h2 id="configure">Configure</h2>
74+
<hr class="mt-0">
75+
76+
<p>You can access Link Extractor through the Icon on the Extension Toolbar or Right Click Context Menu.</p>
77+
<p>You can pin the Addon by locating the Link Extractor icon on the Extension Toolbar, then;</p>
78+
<ul>
79+
<li><strong>Firefox</strong>, click the Settings Wheel and Pin to Toolbar.<br></li>
80+
<li><strong>Chrome</strong>, click the Pin icon.<br></li>
81+
</ul>
82+
83+
<div class="mb-2">
84+
<img src="/images/extension/pin-chrome.jpg" class="img-thumbnail" alt="Chrome Pin Extension" width="350">
85+
<img src="/images/extension/pin-firefox.jpg" class="img-thumbnail" alt="Chrome Pin Extension" width="320">
86+
</div>
87+
88+
<h2>Setup</h2>
89+
<p>
90+
To automatically configure the web extension to work with your Django Files instance do the following:
91+
</p>
92+
<ul>
93+
<li>Log in to your Django Files Instance</li>
94+
<li>Click the Popup Icon (from above)</li>
95+
<li>Click Add Auth from Current Site</li>
96+
</ul>
97+
<div class="mb-2">
98+
<img src="/images/extension/setup.jpg" class="img-thumbnail" alt="Chrome Pin Extension" width="350">
99+
</div>
100+
<p>
101+
The addon should now be configured to work with your Django Files instance.
102+
</p>
103+
<p>
104+
You can now click the Django Files icon to view your recent uploads or open Options.
105+
Right-click on any Image, Video, Audio, or URL upload to Django Files or Shorten URL.
106+
</p>
107+
108+
<p>
109+
Alternatively, you can open the Options page and add your URL and Token.
110+
</p>
111+
112+
<h2 id="usage">Usage</h2>
113+
<hr class="mt-0">
114+
115+
<p>Activate 1 of 3 ways:</p>
116+
<ul>
117+
<li>Toolbar Icon Popup</li>
118+
<li>Keyboard Shortcuts</li>
119+
<li>Right Click Context Menu</li>
120+
</ul>
121+
122+
<h2>Support</h2>
123+
124+
<p>
125+
Please submit an
126+
<a href="{{ site.github_url }}/issues" target="_blank">Issue</a>
127+
if you find bugs and open a
128+
<a href="{{ site.github_url }}/discussions/categories/feature-requests" target="_blank">Feature Request</a>
129+
if you have any ideas, suggestions, or requests.
130+
</p>
131+
132+
<p>
133+
More information can be found on GitHub,
134+
<a href="https://github.com/django-files/web-extension" target="_blank" rel="noopener">django-files/web-extension</a>.
135+
</p>

images/extension/pin-chrome.jpg

33.9 KB
Loading

images/extension/pin-firefox.jpg

26.5 KB
Loading

images/extension/popup.jpg

98.8 KB
Loading

images/extension/setup.jpg

40.2 KB
Loading

0 commit comments

Comments
 (0)