getCustomers(); if(count($customers) == 0) throw new Exception("At least one customer must exist before this page can be accessed."); else if(count($customers) == 1) { $customer = array_shift($customers); } else { $customer_id = http::value("customer_id", "int"); if(!$customer_id) { $page_title = "Select Customer"; View::includeOnce("header", compact("page_title")); View::include("customer_select", compact("customers")); View::includeOnce("footer"); exit; } $customer = Customer::get($customer_id); // Enforce restriction if user cannot access locations if(!$user->canAccessLocations()) { $link = UserCustomer::get(Core::$user->id, $customer_id); if(!$link) $customer = null; } } if(empty($customer)) throw new Exception("Customer not found."); return $customer; } // Object methods /** * @param array $query * @return Location[] * @throws Exception */ public function getLocations(array $query = []): array { $nvp = array_merge(["customer_id" => $this->id], $query); return Location::query($nvp, ["sort" => "name"]); } /** * @return Project[] * @throws Exception */ public function getProjects(array $nvp = []): array { $nvp = array_merge($nvp, ["customer_id" => $this->id]); return Project::query($nvp, [ "sort" => "dts_deadline", "order" => "desc" ]); } public function getFinishedProjects() { $projects = array_filter($this->getProjects(), function(Project $p) { return $p->isFinished(); }); return array_values($projects); } /** * @return Template[] * @throws Exception */ public function getTemplates() { return Template::query(["customer_id" => $this->id], ["sort" => "name"]); } /** * @return string */ public function getTestResultsUrl(): string { $slug = Util::slugWithId($this->name, $this->id); $url = "/account/test-results/{$slug}"; return $url; } public function getYearCycleDates(): array { $month = $this->year_cycle_month; if(!$month) $month = 1; $current_year = date("Y"); $current_month = date("n"); if($current_month >= $month) { $min_dts = sprintf("%d-%02d-01", $current_year, $month); $max_dts = sprintf("%d-%02d-01", $current_year + 1, $month); } else { $min_dts = sprintf("%d-%02d-01", $current_year - 1, $month); $max_dts = sprintf("%d-%02d-01", $current_year, $month); } $min_time = strtotime($min_dts); $max_time = strtotime($max_dts) - 1; return [ date("Y-m-d", $min_time), date("Y-m-d", $max_time), ]; } public function getYearCycleConstraint(string $tz): Constraint { [$min_date, $max_date] = $this->getYearCycleDates(); $dt_min = CarbonImmutable::parse($min_date, $tz)->startOfDay()->utc(); $dt_max = CarbonImmutable::parse($max_date, $tz)->endOfDay()->utc(); return Constraint::between($dt_min, $dt_max); } public function getDisplayYearCycle(): string { [$date_start, $date_end] = $this->getYearCycleDates(); $dt_start = CarbonImmutable::parse($date_start); $dt_end = CarbonImmutable::parse($date_end); return sprintf("%s - %s", $dt_start->format("d/m/Y"), $dt_end->format("d/m/Y")); } public function getLogoPath(): ?string { $slug = Util::slug($this->name); $slug = str_replace("-", "_", $slug); $path = sprintf("public/img/customer_logos/%s_logo.png", $slug); if(file_exists(ROOT_DIR . "/" . $path)) return $path; return null; } /** * @return Test[] * @throws Exception */ public function getLatestTestByLocation(): array { $output = []; $tests = Test::query([ "status" => Constraint::notEquals(Test::STATUS_CANCELLED), "location_id" => array_column($this->getLocations(), "id") ], ["sort" => "dts_start", "order" => "asc"]); foreach($tests as $test) { $output[$test->location_id] = $test; } return $output; } /** * @param string $field * @return string[] * @throws Exception */ public function getLocationFieldValues(string $field): array { $names = []; foreach($this->getLocations() as $location) { $names[] = $location->$field; } $names = array_values(array_unique(array_filter($names))); usort($names, Util::getStringSorter()); return $names; } /** * @return string[] * @throws Exception */ public function getBrands(): array { return $this->getLocationFieldValues("brand"); } /** * @return string[] * @throws Exception */ public function getRegions(): array { return $this->getLocationFieldValues("region"); } /** * @return string[] * @throws Exception */ public function getAreaManagerNames(): array { return $this->getLocationFieldValues("area_manager"); } /** * @return string[] * @throws Exception */ public function getGamingManagerNames(): array { return $this->getLocationFieldValues("gaming_manager_name"); } /** * @return string[] * @throws Exception */ public function getSeniorGamingManagerNames(): array { return $this->getLocationFieldValues("senior_gaming_manager_name"); } /** * @return string[] * @throws Exception */ public function getOperationsManagerNames(): array { return $this->getLocationFieldValues("operations_manager_name"); } public function getConfig(): object { return json_decode($this->config_json) ?: new stdClass(); } public function getBrandLabel(int $count): string { $default_labels = [__("Brand"), __("Brands")]; $index = ($count === 1) ? 0 : 1; return $this->getConfig()->brandLabels[$index] ?? $default_labels[$index]; } public function getRegionLabel(int $count): string { $default_labels = [__("Region"), __("Regions")]; $index = ($count === 1) ? 0 : 1; return $this->getConfig()->regionLabels[$index] ?? $default_labels[$index]; } public function getAreaManagerLabel(int $count): string { $default_labels = [__("Area Manager"), __("Area Managers")]; $index = ($count === 1) ? 0 : 1; return $this->getConfig()->areaManagerLabels[$index] ?? $default_labels[$index]; } public function getOperationsManagerLabel(int $count): string { $default_labels = [__("Operations Manager"), __("Operations Managers")]; $index = ($count === 1) ? 0 : 1; return $this->getConfig()->operationsManagerLabels[$index] ?? $default_labels[$index]; } public function getGamingManagerLabel(int $count): string { $default_labels = [__("Gaming Manager"), __("Gaming Managers")]; $index = ($count === 1) ? 0 : 1; return $this->getConfig()->gamingManagerLabels[$index] ?? $default_labels[$index]; } public function getSeniorGamingManagerLabel(int $count): string { $default_labels = [__("Senior Gaming Manager"), __("Senior Gaming Managers")]; $index = ($count === 1) ? 0 : 1; return $this->getConfig()->seniorGamingManagerLabels[$index] ?? $default_labels[$index]; } public function getCcEmailAddresses(): array { $addresses = json_decode($this->cc_email_json); return is_array($addresses) ? $addresses : []; } public function setCcEmailAddresses(array $addresses): void { foreach($addresses as $address) { $valid = filter_var($address, FILTER_VALIDATE_EMAIL); if(!$valid) { throw new RuntimeException(__("%s is not a valid email address.", $address)); } } $this->cc_email_json = json_encode($addresses); } public function isBillingEnabled(): bool { $config = $this->getConfig(); return !empty($config->billingEnabled); } }