dynamic / silverstripe-jobs

src/Page/Job.php

<?php

namespace Dynamic\Jobs\Page;

use Dynamic\Jobs\Model\JobCategory;
use Dynamic\Jobs\Model\JobSection;
use Dynamic\Jobs\Model\JobSubmission;
use \Page;
use SilverStripe\Control\Controller;
use SilverStripe\Forms\DateField;
use SilverStripe\Forms\DropdownField;
use SilverStripe\Forms\FieldList;
use SilverStripe\Forms\GridField\GridField;
use SilverStripe\Forms\GridField\GridFieldAddExistingAutocompleter;
use SilverStripe\Forms\GridField\GridFieldConfig_RelationEditor;
use SilverStripe\Forms\GridField\GridFieldDeleteAction;
use SilverStripe\Forms\ListboxField;
use SilverStripe\Forms\TreeMultiselectField;
use SilverStripe\ORM\Search\SearchContext;
use SilverStripe\Security\Permission;
use SilverStripe\Security\PermissionProvider;
use Symbiote\GridFieldExtensions\GridFieldAddExistingSearchButton;
use Symbiote\GridFieldExtensions\GridFieldOrderableRows;

/**
 * Class Job
 * @package Dynamic\Jobs\Model
 */
class Job extends Page implements PermissionProvider
{
    /**
     * @var string
     */
    private static $table_name = 'Dynamic_Job';

The private property $table_name is not used, and could be removed.

    /**
     * @var array
     */
    private static $db = [

The private property $db is not used, and could be removed.

        'PositionType' => "Enum(array('Full-time', 'Part-time', 'Freelance', 'Internship'))",
        'PostDate' => 'Date',
        'EndPostDate' => 'Date',
    ];

    /**
     * @var array
     */
    private static $has_many = [

The private property $has_many is not used, and could be removed.

        'Sections' => JobSection::class,
        'Submissions' => JobSubmission::class,
    ];

    /**
     * @var array
     */
    private static $many_many = [

The private property $many_many is not used, and could be removed.

        'Categories' => JobCategory::class,
    ];

    /**
     * @var array
     */
    private static $many_many_extraFields = [

The private property $many_many_extraFields is not used, and could be removed.

        'Categories' => [
            'Sort' => 'Int',
        ],
    ];

    /**
     * @var array
     */
    private static $searchable_fields = [

The private property $searchable_fields is not used, and could be removed.

        'Title',
        'Categories.ID' => [
            'title' => 'Category',
        ],
        'PositionType' => [
            'title' => 'Type',
        ],
    ];

    /**
     * @var string
     */
    private static $default_parent = JobCollection::class;

The private property $default_parent is not used, and could be removed.

    /**
     * @var bool
     */
    private static $can_be_root = false;

The private property $can_be_root is not used, and could be removed.

    /**
     * @var bool
     */
    private static $show_in_sitetree = false;

The private property $show_in_sitetree is not used, and could be removed.

    /**
     * @var array
     */
    private static $allowed_children = [];

The private property $allowed_children is not used, and could be removed.

    /**
     * @return SearchContext
     */
    public function getCustomSearchContext()
    {
        $fields = $this->scaffoldSearchFields([
            'restrictFields' => [
                'Title',
                'Categories.ID',
                'PositionType',
            ],
        ]);

        $filters = $this->defaultSearchFilters();

        return new SearchContext(
            $this->ClassName,
            $fields,
            $filters
        );
    }

    /**
     *
     */
    public function populateDefaults()
    {
        $this->PostDate = date('Y-m-d');

The property PostDate does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

        parent::populateDefaults();
    }

    /**
     * @param bool $includerelations
     * @return array
     */
    public function fieldLabels($includerelations = true)
    {
        $labels = parent::fieldLabels($includerelations);

        $labels['Title'] = _t(__CLASS__ . '.TitleLabel', 'Position Name');
        $labels['Content'] = _t(__CLASS__ . '.ContentLabel', 'Introduction');
        $labels['PositionType'] = _t(__CLASS__ . '.PositionTypeLabel', 'Position Type');
        $labels['PostDate'] = _t(__CLASS__ . '.PostDateLabel', 'Post Start Date');
        $labels['EndPostDate'] = _t(__CLASS__ . '.EndPostDateLabel', 'Post End Date');
        $labels['Details'] =  _t(__CLASS__ . '.DetailsTab', "Details");
        $labels['Submissions'] = _t(__CLASS__ . '.SubmissionsTab', 'Submissions');
        //$labels['Categories'] = _t(JobCategory::class . '.SlideType', 'Image or Video');

        return $labels;
    }

    /**
     * @return FieldList
     */
    public function getCMSFields()
    {
        $this->beforeUpdateCMSFields(function ($fields) {
            $fields->dataFieldByName('Content')
                ->setTitle($this->fieldLabel('Content'))
                ->setRows(10);

            $fields->addFieldsToTab('Root.' . $this->fieldLabel('Details'), [
                DropdownField::create(
                    'PositionType',
                    $this->fieldLabel('PositionType'),
                    Job::singleton()->dbObject('PositionType')->enumValues()
                )->setEmptyString('--select--'),
                DateField::create('PostDate', $this->fieldLabel('PostDate'))
                    ->setDescription(_t(
                        __CLASS__ . '.PostDateDescription',
                        'Date position should appear on website'
                    )),
                DateField::create('EndPostDate', $this->fieldLabel('EndPostDate'))
                    ->setDescription(_t(
                        __CLASS__ . '.EndPostDateDescription',
                        'Date position should be removed from website'
                    )),
            ]);

            if ($this->ID) {
                // categories
                $categoriesField = ListboxField::create(
                    'Categories',
                    _t(JobCategory::class . '.PLURALNAME', 'Categories'),
                    JobCategory::get()->map()
                );

                $fields->addFieldsToTab('Root.' . $this->fieldLabel('Details'), [
                    $categoriesField,
                ]);

                // sections
                $config = GridFieldConfig_RelationEditor::create();
                $config
                    ->addComponent(new GridFieldOrderableRows('Sort'))
                    ->addComponent(new GridFieldDeleteAction(false))
                    ->removeComponentsByType(GridFieldAddExistingAutocompleter::class)
                    ->removeComponentsByType(GridFieldDeleteAction::class);

                $sections = $this->Sections()->sort('Sort');

The method Sections() does not exist on Dynamic\Jobs\Page\Job. Since you implemented __call, consider adding a @method annotation.

                $sectionsField = GridField::create(
                    'Sections',
                    _t(JobSection::class . '.PLURALNAME', 'Sections'),
                    $sections,
                    $config
                )
                    ->setDescription(_t(
                        __CLASS__ . '.SectionsDescription',
                        'ex: Requirements, Education, Duties, etc.'
                    ));

                $fields->addFieldsToTab('Root.Main', [
                    $sectionsField,
                ]);

                // submissions
                $config = GridFieldConfig_RelationEditor::create();
                $config
                    ->addComponent(new GridFieldDeleteAction(false))
                    ->removeComponentsByType(GridFieldAddExistingAutocompleter::class)
                    ->removeComponentsByType(GridFieldDeleteAction::class);

                $submissions = $this->Submissions();

The method Submissions() does not exist on Dynamic\Jobs\Page\Job. Since you implemented __call, consider adding a @method annotation.

                $submissionsField = GridField::create(
                    'Submissions',
                    _t(JobSubmission::class . '.PLURALNAME', 'Submissions'),
                    $submissions,
                    $config
                )
                ;
                $fields->addFieldsToTab('Root.' . $this->fieldLabel('Submissions'), [
                    $submissionsField,
                ]);
            }
        });

        return parent::getCMSFields();
    }

    /**
     * @return string
     */
    public function getApplyButton()
    {
        $apply = Controller::join_links(
            $this->Link(),
            'apply'
        );
        return $apply;
    }

    /**
     * @return mixed
     */
    public function getApplicationLink()
    {
        if ($this->parent()->Application()->ID != 0) {
            return $this->parent()->Application()->URL;
        }
        return false;
    }

    /**
     * @return mixed
     */
    public function getCategoryList()
    {
        return $this->Categories()->sort('Sort');

The method Categories() does not exist on Dynamic\Jobs\Page\Job. Since you implemented __call, consider adding a @method annotation.

    }

    /**
     * @return bool
     */
    public function getPrimaryCategory()
    {
        if ($this->Categories()->exists()) {
            return $this->Categories()->first();
        }
        return false;
    }

    /**
     * @return array
     */
    public function providePermissions()
    {
        return [
            'JOB_MANAGE' => [
                'name' => _t(
                    __CLASS__ . '.JOB_MANAGE',
                    'Manage Jobs'
                ),
                'category' => _t(
                    __CLASS__ . '.JOB_MANAGE_CATEGORY',
                    'Jobs'
                ),
                'help' => _t(
                    __CLASS__ . '.JOB_MANAGE_HELP',
                    'Access to add, edit and delete Jobs'
                ),
                'sort' => 400,
            ],
        ];
    }

    /**
     * @param null $member

Are you sure the doc-type for parameter $member is correct as it would always require null to be passed?

     *
     * @return bool|int
     */
    public function canEdit($member = null)
    {
        return Permission::check('JOB_MANAGE', 'any', $member);
    }

    /**
     * @param null $member

Are you sure the doc-type for parameter $member is correct as it would always require null to be passed?

     *
     * @return bool|int
     */
    public function canDelete($member = null)
    {
        return Permission::check('JOB_MANAGE', 'any', $member);
    }

    /**
     * @param null $member

Are you sure the doc-type for parameter $member is correct as it would always require null to be passed?

     *
     * @return bool|int
     */
    public function canCreate($member = null, $context = [])
    {
        return Permission::check('JOB_MANAGE', 'any', $member);
    }
}