jreviews:permission:listing.set_listing_title
Filters whether a user has permission to manually set a listing title. When automated title format is configured, this controls if the user can override it.
You need to have a working knowledge of Hooks before you get started.
Fires when checking if the listing title field should be shown or if user input should be accepted for the title
Parameters
| Name | Type | Description |
|---|---|---|
$canSetTitle |
bool |
Whether the user can set the title (always true in admin, or when title field is enabled, or when automated title format is empty) |
$user |
\JReviews\App\Models\User |
The user attempting to set the title |
$listing |
\JReviews\App\Models\Listing |
The listing whose title is being set |
Boilerplate Code
Use the boilerplate code to start using the filter, and add your own logic to modify the first argument and return it.
fwd_add_filter('jreviews:permission:listing.set_listing_title', function($canSetTitle, $user, $listing)
{
// Your code here
return $canSetTitle;
}, 20, 3);
The , 20, N after your callback are the hook priority and the number of arguments your callback accepts. By default, a hook passes your callback only its first argument; for a filter, that is the value being filtered, so a simple function($value) { ... } needs nothing extra. If your callback declares more parameters, such as function($value, $listing) { ... }, you must add N (the parameter count, 2 here). Because N is the fourth argument to fwd_add_filter() or fwd_add_action(), you must also pass the priority (20 is the default). Leaving these off when your callback expects extra parameters causes a Too few arguments to function ... fatal error.
Source Files
app/Policies/ListingPolicy.php