You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CHANGELOG.md
+20Lines changed: 20 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,25 @@
1
1
# DeviantArt Filter Changelog
2
2
3
+
## Version 6.0.0 Alpha 1 (April 14, 2020)
4
+
5
+
*(**Tote**: This entry may be updated and/or replaced with future version 6.0.0 alpha/beta/final/etc release information.)*
6
+
7
+
### New Features
8
+
9
+
-**Eclipse Support**. DeviantArt Filter now supports [the new site (a.k.a Eclipse)](https://www.deviantarteclipse.com/). It also supports the "classic" site fore users who are not yet using Eclipse.
10
+
-**New Management Page**. The management page has been completely rewritten using more modern frameworks.
11
+
-**Filter by Title**. Tag filters have been replaced with keyword filters, which apply to both tags and titles for all deviations.
12
+
-**Quick Filter Tag Context Menu**. A new context (right-click) menu is available on all tag links; use this to quickly create a keyword filter for the linked tag.
13
+
-**Faster Metadata Lookup**. DeviantArt Filter v6+ uses faster APIs to load metadata (tags and categories) while you browse, so filters should apply faster than they did in v5.x.
14
+
15
+
### Known issues
16
+
17
+
-**Filters are not validated**. When creating/updating filters, no restrictions or validations are implemented to help prevent invalid filters from being created.
18
+
-**Options are missing**. There are currently no configurable options for DeviantArt Filter v6.0.0.
19
+
-**Placeholders**: Placeholders cannot be disabled for the new Eclipse site, as the Eclipse layout calculates grid positions for each thumbnail, and removing an item from the grid breaks the layout. The ability to turn off placeholders may be re-implemented for the classic site in the future, but there are currently no plans to bring it back.
20
+
-**Placeholder Colors**: The colors for placeholders cannot currently be adjusted, but are instead hard-coded for each site theme (dark/light/green for Eclipse, and classic).
21
+
-**Metadata Caching**: DeviantArt Filter v6.0.0 does not currently cache metadata like v5.x did; it metadata caching is re-implemented, the corresponding options will be brought back to allow users to disable/configure the caching behavior.
> Allows configurable filtering/removal of deviations by user, tag, and/or category on DeviantArt
3
+
> Allows configurable filtering/removal of deviations by user, keyword, and/or category on DeviantArt
7
4
8
5
## Table of Contents
9
6
@@ -14,31 +11,17 @@
14
11
-[Options](#options)
15
12
-[Screenshots](#screenshots)
16
13
17
-
_(TOC generated by [verb](https://github.com/verbose/verb) using [markdown-toc](https://github.com/jonschlinkert/markdown-toc))_
18
-
19
14
## Overview
20
15
21
-
Have you ever want to block/filter deviations (a.k.a. submissions) while browsing [DeviantArt](https://www.deviantart.com)? **Well now you can!** Simply [install DeviantArt Filter](#installation) in your web browser of choice and start filtering by user, tag, and/or category.
16
+
Have you ever want to block/filter deviations (a.k.a. submissions) while browsing [DeviantArt](https://www.deviantart.com)? **Well now you can!** Simply [install DeviantArt Filter](#installation) in your web browser of choice and start filtering by user, keyword, and/or category.
| Google Chrome |[![Chrome Web Store][chrome-image-version]][chrome-url][![Chrome Web Store][chrome-image-download]][chrome-url]|[Download from the Chrome Web Store][chrome-url]|[README for Chrome](/docs/chrome/README.md#readme)|
32
-
| Mozilla Firefox |[![Mozilla Add-on][firefox-image-version]][firefox-url][![Mozilla Add-on][firefox-image-download]][firefox-url]|[Download from Mozilla Add-ons][firefox-url]|[README for Firefox](/docs/firefox/README.md#readme)|
33
-
| Microsoft Edge |_Coming Soon ([#40](https://github.com/rthaut/deviantART-Filter/issues/40))_|_N/A_|_N/A_|
***Find the latest alpha/beta builds on the [releases](https://github.com/rthaut/deviantART-Filter/releases) page.***
42
25
43
26
* * *
44
27
@@ -56,48 +39,52 @@ This permission is used to apply filters to DeviantArt pages and to add the quic
56
39
57
40
### Access browsing history
58
41
59
-
The History permission is used to remove the DeviantArt Filter Management Panel/Screen from your browser's history.
42
+
The History permission is used to remove the DeviantArt Filter Management Page from your browser's history.
60
43
61
44
### Display notifications to you
62
45
63
46
The Notifications permission is used to display a notification message when upgrading from version 4.x to version 5.x.
64
47
65
48
### Access browser tabs
66
49
67
-
The Tabs permission is used to apply filter changes from the Management Panel/Screen to all open DeviantArt tabs, to enable/disable the DeviantArt Filter icon, and to switch to the Management Panel/Screen (if it is already open) when clicking the DeviantArt Filter icon.
50
+
The Tabs permission is used to apply filter changes from the Management Page to all open DeviantArt tabs, to enable/disable the DeviantArt Filter icon, and to switch to the Management Page (if it is already open) when clicking the DeviantArt Filter icon.
68
51
69
52
* * *
70
53
71
54
## Usage
72
55
73
-
### Opening the Management Panel/Screen
56
+
### Opening the Management Page
74
57
75
58
1. While on [DeviantArt](https://www.deviantart.com), click the red logo that appears on the right side of the address bar. 
76
59
2. The configuration screen will open automatically when you click the icon.
77
60
78
61
### Creating and Removing Filters
79
62
80
-
#### You can filter deviations by artist, category, and/or tag through the management panel/screen
63
+
#### You can filter deviations by artist, category, and/or keyword through the management page
81
64
82
-
1. After [opening the Management Panel/Screen](#opening-the-management-panelscreen), navigate to any of the Manage [Users](#manage-users-page)/[Tags](#manage-tags-page)/[Categories](#manage-categories-page) tabs.
83
-
2. To create a new filter, use the form at the top of the tab.
84
-
- For users, enter their username.
85
-
- For tags, enter a single tag (*no spaces*), then choose if the tag should use wildcard matching.
86
-
- For categories, select the parent category, then (optionally) select sub-categories.
87
-
3. Use the table that is displayed below the form to view all of your existing filters.
65
+
1. After opening the [Management Page](#dashboard), navigate to any of the Manage [Users](#manage-users)/[Keywords](#manage-keywords)/[Categories](#manage-categories) views.
66
+
2. Use the table that is displayed to view all of your existing filters.
88
67
- You can sort the table by clicking the heading of any column.
89
-
- You can page through your filters using the pagination controls in the lower-left corner.
90
-
- You can choose how many filters are displayed per page using the controls in the lower-right corner.
91
-
4. To remove a filter, click the `Remove Filter` button next to the filter you want to remove.
68
+
- You can page through your filters using the pagination controls below the table.
69
+
3. To create a new filter, use the plus icon (:heavy_plus_sign:) above the table to the right of the search bar.
70
+
- For users, enter their username.
71
+
- For keywords, enter a single keyword (*no spaces*), then choose if the keyword should use wildcard matching by checking the wildcard checkbox.
72
+
- For categories, select the category path from the menu (you can type in the field to filter results).
73
+
4. To change an existing filter, like the pencil icon (:pencil2:) next to the filter you want to change.
74
+
- Click the checkmark icon (:heavy_check_mark:) to the left of the filter you are changing to **save** your change(s).
75
+
- Click the multiplication icon (:heavy_multiplication_x:) next to the left of the filter you are changing to **discard** your change(s).
76
+
5. To remove a filter, click the trash can button next to the filter you want to remove.
77
+
- Click the checkmark icon (:heavy_check_mark:) to the left of the filter you are removing to **confirm**.
78
+
- Click the multiplication icon (:heavy_multiplication_x:) next to the left of the filter you are changing to **cancel**.
92
79
93
80
### Exporting/Importing Filters
94
81
95
82
DeviantArt Filter allows you to export and import filters from a JSON file. This is mostly for keeping your filters in sync between browsers/computers, but is handy for backup purposes as well.
96
83
97
-
1. After [opening the Management Panel/Screen](#opening-the-management-panelscreen), navigate to the [Import/Export Filters](#importexport-filters-page) tab.
84
+
1. After [opening the Management Page](#opening-the-management-page), navigate to the [Import/Export Filters](#importexport-filters) view.
98
85
2. To export your current filters to a JSON file, click the `Export Filter Data` button, then open/save the file when prompted (it will use your browser's native download functionality).
99
86
3. To import filters from a JSON file, either drag and drop the file onto the designated box, or click the box to open a File Browser dialog and select your JSON file.
100
-
- After the import has finished, a table showing the results of the import will be displayed. This includes how many filters were imported successfully, as well as how many filters failed to import (either because they were invalid or were duplicate).
87
+
- After the import has finished, a table showing the results of the import will be displayed. This includes how many filters were imported successfully, as well as how many filters failed to import and how many were duplicates.
101
88
102
89
### Quick Hiding Users While Browsing
103
90
@@ -109,72 +96,28 @@ DeviantArt Filter allows you to export and import filters from a JSON file. This
109
96
110
97
## Options
111
98
112
-
Options for DeviantArt filtered are configured through the [Management Panel/Screen](#opening-the-management-panelscreen) on the [Options](#options-page) tab.
113
-
114
-
### Use Placeholders for Filtered Deviations
115
-
116
-
`When enabled, a placeholder image is displayed instead of the actual thumbnail for filtered deviations. Disable this setting to completely remove filtered deviation thumbnails.`
117
-
118
-
If you want to see/know when a deviation was filtered (and why), enable this option (it is enabled by default). This will show a placeholder instead of the deviation's thumbnail (similar to Mature Content that is blocked). If you would rather just completely hide deviations matching any of your filters, disable this option, and the thumbnails will be removed entirely.
119
-
120
-
### Background/Logo/Text Color for Placeholders
121
-
122
-
`Set a custom color for the background/logo/text of the placeholder shown in place of filtered deviations.`
123
-
124
-
Use these three options to control the style of the placeholders that are inserted for filtered deviations. These settings are ignored when placeholders are disabled altogether.
125
-
126
-
### Management Panel Type
127
-
128
-
`Specifies where/how the main management panel is displayed when clicking the DeviantArt Filter logo by the address bar.`
129
-
130
-
This option allows you to control if the DeviantArt Filter Management page is opened in a new tab in your current browser window, or if a new popup window is opened. The default behavior for this option is to use a new tab in the current window.
131
-
132
-
### Metadata Batch Size
133
-
134
-
`Specifies the number of deviations for which to load metadata at a time. Setting this value to a lower number may improve browsing performance.`
135
-
136
-
This option limits how much metadata (used for category and tag filters) is loaded at once. The default is 96, which means that metadata for up to 96 deviations is retrieved for deviations on the page and loaded for the tag and category filters to use. Lowering this number may improve browsing performance, so you can try different values for this option to see if you notice any improvements.
137
-
138
-
### Number of Days to Cache Metadata
139
-
140
-
`Specifies the number of days to cache metadata (for tags and categories) locally for deviations. Set this value to disable local caching completely.`
141
-
142
-
By default, DeviantArt Filter caches the metadata for deviations while browsing [DeviantArt](https://www.deviantart.com) on your computer. This is done so that your category and tag filters can be applied more quickly on subsequent visits, as retrieving metadata for each page of deviations takes 2-5 seconds on an average internet connection. You can disable the local cache completely by setting this option to `0`, but this will cause a noticeable delay before tag and category filters are applied. You can also increase this setting, although setting a value that is too large may cause performance issues.
143
-
144
-
### Show Metadata Debug Indicators
145
-
146
-
`When enabled, deviation thumbnails with missing metadata (for tags and categories) have a red outline, and deviations with metadata have a green outline. This is primarily for debugging, but can be a neat visual for curious people.`
147
-
148
-
This setting, as the description states, is primarily for troubleshooting and debugging. It is used simply to show which deviations have loaded metadata (i.e. their tags and which category they are in). Because metadata has to be fetched from DeviantArt's API, your tag and category filters cannot be applied until that metadata is loaded. The outlines (green for loaded, red for NOT loaded), can help you see why your filters may not seem to be working.
99
+
*Options are currently **not** available in DeviantArt Filter v6.0.0*
149
100
150
101
* * *
151
102
152
103
## Screenshots
153
104
154
-
### Options Page
155
-
156
-
157
-
158
-
### Manage Users Page
159
-
160
-
161
-
162
-
### Manage Tags Page
105
+
### Dashboard
163
106
164
-
107
+
165
108
166
-
### Manage Categories Page
109
+
### Manage Users
167
110
168
-
111
+
169
112
170
-
### Import/Export Filters Page
113
+
### Manage Keywords
171
114
172
-
115
+
173
116
174
-
### Browse Page with Placeholders Enabled
117
+
### Manage Categories
175
118
176
-
119
+
177
120
178
-
### Browse Page with Placeholders Disabled
121
+
### Import/Export Filters
179
122
180
-
123
+
0 commit comments