Editing Filename Filters

From FileZilla Wiki
Jump to navigationJump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
 
Filename filters provide a way to filter out files and directories with respect to both visibility and transfers.
 
Filename filters provide a way to filter out files and directories with respect to both visibility and transfers.
  
−
= Showing Filters =
+
= Configuring Filters =
  
−
To show and configure filters:
+
To configure filters, click on the toolbar icon, or use the drop-down menu to go to "View > Filename filters...". This will bring up a dialog box showing the local filters on the left side, and the remote filters on the right side. Multiple filters may be active at a time — those filters that are active will have a check next to them.
−
* click on the proper toolbar icon (the 4th from the right), or  
 
−
* select "View > Filename filters...".  
 
  
−
This will bring up the 'Directory listing filters' dialog box, that shows :
+
= Creating & Modifying Filters =
−
* on the left side : the local filters
 
−
* on the right side : the remote filters.
 
  
−
Multiple filters may be active at a time — those filters that are active will have a check next to them.
+
To modify filters, select the "Edit Filters" button at the top right of the filter dialog. This will open the "Edit filters" dialog.
  
−
= Modifying Filters =
+
On the left side, you'll see a list of existing filters (which may or may not be active). To rename, copy or delete a filter, select the existing filter and hit the appropriate button below.
  
−
To modify filters, select the "Edit filter rules..." button at the bottom left of the filter dialog. This opens the "Edit filters" dialog, that shows:
+
== Creating a New Filter ==
−
* On the left side : a list of existing filters (which may or may not be active).
 
−
* On the right side : the select criteria for the filter selected on the left panel.
 
  
−
To rename, copy or delete a filter, select the existing filter and hit the appropriate button below.
+
To create a new filter, press the New button, enter the filter name. At that point, the filter will appear in the left-hand pane, and will be selected. At this point, you're ready to edit the filter settings.
  
−
= Creating a New Filter =
+
== Filter Criteria ==
 +
 
 +
=== Match Any, All, or None ===
 +
 
 +
=== Name Criteria ===
  
−
To create a new filter:
+
Filename critera can be one of the following:
−
* Press the New button,
 
−
* Enter the filter name. The filter will appear in the left-hand pane, and will be selected.
 
−
* Edit the filter settings, as described below.
 
  
−
== The 'Filter Conditions' box ==
+
; contains
 +
: Matches if the file/directory name contains the specified literal string.
  
−
Choose if the filter match :
+
; is equal to
−
* Any,
+
: Matches if the file/directory name exactly matches the specified literal string.
−
* All, or
 
−
* None
 
−
of the criteria defined bellow.
 
  
−
== Filter Criteria ==
+
; begins with
 +
: Matches if the file/directory name begins with the specified literal string.
  
−
Your option on the left box define the options available on the middle box, described right ahead, and what you will type on the right box.  
+
; ends with
 +
: Matches if the file/directory name ends with the specified literal string.
  
−
=== Name Criteria ===
+
; matches regex
 +
: Matches the specified [[Regular_Expressions|regular expression]].
  
−
Filename and Path allow the same options on the middle box. They can be one of the following:
 
−
* contains : matches if the file/directory name contains the specified literal string.
 
−
* is equal to : matches if the file/directory name exactly matches the specified literal string.
 
−
* begins with : matches if the file/directory name begins with the specified literal string.
 
−
* ends with : matches if the file/directory name ends with the specified literal string.
 
−
* matches regex : matches the specified [[Regular_Expressions|regular expression]].
 
  
 
=== Size Criteria ===
 
=== Size Criteria ===
  
 
Filesize criteria can be one of the following:
 
Filesize criteria can be one of the following:
−
* greater than :
 
−
* equals :
 
−
* less than :
 
  
−
=== Date Criteria ===
+
; greater than :
 +
; equals :
 +
; less than :
  
−
The date criterion is relative to a date which the user must enter. This feature, found in version 3.11.01 for Windows 64-bit,  is not documented by the authors. The following format has been tried and appears to work correctly: AAAA-MM-DD HH:MM specifies the date and time in local time where AAAA is a four-digit year, MM the month number (01 for January, 02 for Feb., ... 12 for Dec.), DD the day of the month (01 to 31), HH the military hour of the day (00 to 23 where 00 is midnight, 01 is 1:00 AM, 12 is noon, 19 is 7:00 PM), MM the minute (00 to 59).  After specifying the date and time you may choose before, after, equals or does not equal (the last two options seem to match any time within 15 minutes of what is specified), and you may include or exclude files based on this criterion, as on other criteria.
 
  
 
=== Attribute Criteria (Windows only) ===
 
=== Attribute Criteria (Windows only) ===
  
 
File attribute criteria test for boolean flags (true or false) corresponding to file or directory attributes. The following attribute criteria are supported:
 
File attribute criteria test for boolean flags (true or false) corresponding to file or directory attributes. The following attribute criteria are supported:
−
* archived :
+
 
−
* compressed :
+
; archived :
−
* encrypted :
+
; compressed :
−
* hidden :
+
; encrypted :
−
* read-only :
+
; hidden :
−
* system :
+
; read-only :
 +
; system :
  
 
=== Attribute Criteria (non-Windows only) ===
 
=== Attribute Criteria (non-Windows only) ===
  
 
File permissons criteria test for boolean flags (true or false) corresponding to file or directory permissions. The following permission criteria are supported:
 
File permissons criteria test for boolean flags (true or false) corresponding to file or directory permissions. The following permission criteria are supported:
−
* owner readable :
 
−
* owner writeable :
 
−
* owner executable :
 
−
* group readable :
 
−
* group writeable :
 
−
* group executable :
 
−
* world readable :
 
−
* world writeable :
 
−
* world executable :
 
  
−
== Contextual Conditions ==
+
; owner readable :
 +
; owner writeable :
 +
; owner executable :
 +
; group readable :
 +
; group writeable :
 +
; group executable :
 +
; world readable :
 +
; world writeable :
 +
; world executable :
 +
 
 +
=== Criteria Conditions ===
  
−
At the bottom of the "Edit filters" dialog box, you can also find :
+
At the bottom of the "Edit filters" dialog box, you can also find a checkbox to make filter conditions (I guess specifically Filter ''Name'' conditions) case sensitive. Newly created filters have this box unchecked, so names are matched regardless of actual letter case.
−
* a checkbox to make filter conditions (I guess specifically Filter ''Name'' conditions) case sensitive. Newly created filters have this box unchecked, so names are matched regardless of actual letter case.
 
−
* two checkboxes where you can select whether the conditions apply to files, or to directories. Both boxes may be checked at the same time. Newly created filters have both files and directories checked.
 
  
−
== Adding and Removing Criteria ==
+
In addition, you can select whether the conditions apply to files, or to directories. Both boxes may be checked at the same time. Newly created filters have both files and directories are checked.
  
−
To remove a criterion from a filter :
+
=== Removing Criteria ===
−
Click the minus button at the right of the criteria fields.
 
  
−
To add another criterion to a filter :
+
To remove a criterion from a filter, click in the blank area to the left of the criteria fields. This should highlight the entire row. Select the "Remove <u>s</u>elected" button to delete the selected criterion.
−
Click the plus button at the right of the criteria fields.
 
  
−
= Saving Filter Sets =
+
= Filter Sets =
 
A selection state of filters can be saved as a ''Filter Set'', from the "Directory listing filters" dialog box.
 
A selection state of filters can be saved as a ''Filter Set'', from the "Directory listing filters" dialog box.

Please note that all contributions to FileZilla Wiki are considered to be released under the GNU Free Documentation License 1.2 (see FileZilla Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

Cancel Editing help (opens in new window)
Retrieved from "https://wiki.filezilla-project.org/Filename_Filters"