View Guide with Images
A predefined set of rules—the whitelist and blacklist—is automatically installed to help with allowing or blocking "safe" or "bad" items. If you want to ignore either or both of these lists, you can do so via the extension's settings page.
You can install the extension from Apple's Safari Extension Gallery or from its website. Either way, once completed, you will see a new toolbar icon appear.
Click the toolbar icon to reveal the main window where everything takes place. If you are on the Safari Extensions Gallery, you will see a popup in the window telling you that while the installation was successful, it will not be able to function on that website. The reason for this is because Apple prevents extensions from running on the gallery for security reasons.
If this is the first install of the extension (i.e. you aren't updating from a previous version) you will see the initial blank window. You'll have to reload your open webpages in order for the window to become populated.
The page selector lets you gain access to the information contained within frames on the active webpage. You can use the frame switcher on the right to quickly navigate through them.
The number next to the Allowed/Blocked headers is the total number of resources affected. It will also count any hidden items and therefore may not match the number of items displayed until clicking Show Hidden.
Each section can be collapsed by hovering over next to header (SCRIPTS, FRAMES, etc.) and clicking Hide.
You can also collapse the the Allowed/Blocked sections by clicking on its header.
The Block or Hide… buttons will reveal a popup which two choices: Some and All. Clicking on Some will reveal check boxes and select boxes so that you can select multiple items to block, allow, or hide all at once. Selecting All will show you check boxes with the type of item to block, allow, or hide (scripts, frames, etc.).
The question mark next to each item will reveal up to two options.
The question mark next to each item will reveal an additional option alongside the ones above.
The extension controls which resources are allowed or blocked based on the domain of the webpage and the source of the item in question. There are several blockers included to control almost anything on a webpage. Only the Script and Frame blockers are enabled by default. Each one has its own default action which can be configured from the settings page under Rules.
Any rule created can be permanent or temporary. A temporary rule is one that will be automatically removed when Safari is restarted.
Rules can be created to always block scripts if they originate from a different hostname, from a different sub-domain, anywhere, or the blacklist only.
Let's say I choose to block rules if they come from a different hostname. Now, I navigate to example.org and it attempts to load a resource from example.com—a different hostname—a rule is created to block any resource originating from example.com on example.org. But if example.org tries loading a resource from sub.example.org, it will be allowed since it is a sub-domain of example.org. This is possible by selecting "Different hostnames" from the preferences for "Automatically block * from:".
If you wanted to allow resources only from the same originating hostname, choose "Different hosts & subdomains" instead. Then, even a resource from sub.example.org will be blocked.
If you wanted to block everything, select "Anywhere".
If you wanted to block only known bad scripts, select "Blacklist only".
One of the most important aspects of the extension is its ability to block scripts. By default, the extension will block any script not originating from within the domain of the webpage you are visiting. This means that you are automatically protected from tracking agencies, advertisers, social networks, etc.
Scripts are considered to be any resource loaded using a
The following blockers are part of the extra features of the extension.
The extension can also prevent
This will block only HTML5
Images will only be prevented from appearing on the webpage. Unfortunately they will still be downloaded, though you will never see them. This is a limitation of WebKit (Safari). All images are allowed by default regardless of where they are from. A placeholder can be used to load specific images by clicking on it.
Snapshots is one of the extension's extra features that automatically creates backups of your rules any time they are modified. You can use it to recover from any accidental changes or to create different rule sets for different situations, such as when you're at home or in public.
You can access the snapshots UI from the rule list by clicking the time machine icon in the actions bar.
Once opened, you will see a summary of how many snapshots there are and how much space they are using. You can limit the amount of UNKEPT snapshots from the settings page.
When you first start off, there will only be snapshots under UNKEPT since they are not saved permanently by default. Clicking Create Snapshot will create a new, unnamed KEPT snapshot with the current date and time.
You can preview a snapshot's rules (i.e. temporarily use them in place of the current rule set) by clicking Preview. This will take you back to the rule list where you will see see all of the rules in the snapshot. The active preview will be green in the snapshots UI.
You can browse around as you normally would to see the rules in action. You will not be able to create or remove any rules while the preview is in use—snapshots are read-only.
From the rule list, you can recover rules to place them in the current rule set by clicking the Recover button next to a rule, where Delete/Restore/Disable would normally be. You can also recover entire domain sets by switching to edit mode (click the little pencil icon in the actions bar). A Recover button will appear next to the domain name. Clicking it will reveal two options: Merge and Replace. Use Merge when you want append the current rules for that domain and Replace to use only the snapshot's version of the domain rules (the current rules for that domain will be removed).
Click the time machine icon again to reveal a popup with Merge Rules and Replace Rules. Use Merge when you want to append your current rule set with rules unique to the snapshot and Replace to turn the snapshot into the current rule set. You can also click Close Snapshot to revert back to the current rule set.
Click on a snapshot's name to reveal a popup.