WOOF_Collection :: by( String $name, String $order = "ASC", Boolean $case_insensitive = true, Boolean $clone = false, String $numeric = "AUTO" )


A synonym for the WOOF_Collection::sort method, to sort the collection by the value of a property specified. A “property” here can be a genuine object property, or the result of a method call as handled by the WOOF_Wrap::get method. 



  • String $name

    The name of the property whose values will be used to sort the collection

  • String $order = "ASC"

    The order of the sort – “ASC” for ascending, “DESC” for descending

  • Boolean $case_insensitive = true

    Whether alphanumeric sorting will ignore case.

  • Boolean $clone = false

    If true, the original collection will be untouched, and a clone of the sorted collection will be returned instead.

  • String $numeric = "AUTO"

    Can be either:
    * “AUTO” which will use numeric sorting for known numeric properties such as menu_order and id, and string sorting for all others,
    * true which will force a numeric sort
    * false which will use string sorting

Latest From the Blog

MasterPress 1.3.10 is now available

9th November 2023

MasterPress 1.3.10 is a feature and bugfix release. Workaround for fatal error introduced by changes to WordPress’ wpdb class in WordPress 6.4. Added actions to MPC files upload_field & WF image save_image functions.

Plugin Requirements

MasterPress requires a minimum of WordPress version 4.9, MySQL 5.6, and PHP version 5.6.20.

We also recommend that PHP is configured to use a memory limit of 64MB per request (128MB may be required for sites with higher complexity).

This plug-in is not compatible with the WordPress.com hosted service.

Three AM