| Table of Contents |
|---|
The following represents namespaces, classes, arguments, or other code/functionality that is currently deprecated. Everything listed here is pending removal. We recommend you update any custom integrations you use (i.e. modules, gateways, plugins, API calls, or custom source code) to no longer use deprecated functionality as soon as possible.
Core
API & Models
Models interface with the data storage system and are callable via the API. They are stored in the /app/models/ directory.
| Source | Description | Alternative | Deprecated Since | Proposed Removal |
|---|---|---|---|---|
| Coupons::getTypes | Coupon types are not used by the system. | 4.1.0 | 5.0 | |
| Coupons::validateType | Coupon types are not used by the system. | 4.1.0 | 5.0 | |
| Coupons::validateInclusiveRecurring | Coupon types are not used by the system. | 4.1.0 | 5.0 | |
| CronTasks::delete | Method arguments have changed, so a new replacement method exists. | CronTasks::deleteTask | 4.3.0 | 5.0 |
| CronTasks::validateKeyUnique | The method provides no beneficial use. | 4.3.0 | 5.0 | |
| CronTasks::validateTaskType | The method provides no beneficial use. | 4.3.0 | 5.0 | |
| Invoices::makeLinesFromItems | This logic has been abstracted to a different library. | Blesta\Core\Pricing\ libraries | 4.1.0 | 5.0 |
| Invoices::getItemTotals | This logic has been abstracted to a different library. | Blesta\Core\Pricing\ libraries | 4.0.0 | 5.0 |
| Logs::getCronList | The plugin_dir property of each retrieved object is no longer relevant and will not be returned. | |||
| Logs::getLatestCron | The plugin_dir property of the retrieved object is no longer relevant and will not be returned. | |||
| Logs::getRunningCronTasks | The plugin_dir property of each retrieved object is no longer relevant and will not be returned. | |||
Controllers
Controllers facilitate the retrieval of data and rendering of views. They are stored in the /app/ and /app/controllers/ directories.
| Source | Description | Alternative | Deprecated Since | Proposed Removal |
|---|---|---|---|---|
| AppController::authorized client contact permissions | AppController::authorized validates client contact permissions too specific for its use. The method will continue to exist, but it will no longer function to check client contact authorization. | Use ClientController::authorized instead | 3.4.0 | 5.0 |
Components
Components are libraries that provide additional utility. They are stored in the /components/ directory.
| Source | Description | Alternative | Deprecated Since | Proposed Removal |
|---|---|---|---|---|
| Events | The Events system has been refactored, therefore the Events component library in its entirety, including EventObject, and all Event_*_Callback classes, are deprecated. This affects the Events object available in all classes inheriting from AppController and AppModel via $this->Events. | Blesta\Core\Util\Events\ library | 4.3.0 | 5.0 |
| Json | The Json component provided support for JSON-encoding in older versions of php that no longer meet minimum system requirements. | Use php's json_encode and json_decode functions | 4.5.0 | 5.0 |
| PricingPresenter | Pricing has been refactored, therefore the PricingPresenter component library is deprecated. | Blesta\Core\Pricing\ libraries | 4.0.0 | 5.0 |
| ReportType Interface | The interface has changed for all report classes, and the ReportType interface is no longer used. | ReportInterface | 4.3.0 | 5.0 |
| VCard::create argument data | Some associative keys passed to the first argument of VCard::create have been deprecated. The first argument to VCard::create is an array of $data. The keys 'email1' and 'office_tel' have been deprecated (i.e. $data['email1'] and $data['office_tel']). | Pass values for $data['email'] and $data['work_tel'] instead | 4.5.0 | 5.0 |
Helpers
Helpers are libraries that help improve the UI. They are stored in the /helpers/ directory.
| Source | Description | Alternative | Deprecated Since | Proposed Removal |
|---|---|---|---|---|
| Areyouahuman | The "Are you a human" verification service used by this helper is no longer available for use. | 4.0.0 | 5.0 | |
| Recaptcha | The Google Recaptcha v1 API was removed and is no longer available for use. v2 of the Google Recaptcha API is supported via a separate library. | Blesta\Core\Util\Captcha\ library | 4.0.0 | 5.0 |
Other Libraries
| Source | Description | Alternative | Deprecated Since | Proposed Removal |
|---|---|---|---|---|
| Blesta\Core\Util\Events\Common\AbstractEvent::getReturnVal | This method only exists to conform with the deprecated Events component interface (i.e. EventObject::getReturnVal) for backward compatibility. | Blesta\Core\Util\Events\Common\AbstractEvent::getReturnValue | 4.3.0 | 5.0 |
| Blesta\Core\Util\Events\Common\AbstractEvent::setReturnVal | This method only exists to conform with the deprecated Events component interface (i.e. EventObject::setReturnVal) for backward compatibility. | Blesta\Core\Util\Events\Common\AbstractEvent::setReturnValue | 4.3.0 | 5.0 |
Plugins
Versions
Deprecated and Removal versions defined for Plugins refer to the version of that particular plugin, not of the version of Blesta.
Order
The Order plugin is an extension included with Blesta by default.
| Source | Description | Alternative | Deprecated Since | Proposed Removal |
|---|---|---|---|---|
| OrderType::requiresItemsOnSignup | The OrderType abstract class defines a public method, requiresItemsOnSignup, which is no longer supported. | 1.3.0 | 3.0 |
Support Manager
The Support Manager plugin is an extension included with Blesta by default.
| Source | Description | Alternative | Deprecated Since | Proposed Removal |
|---|---|---|---|---|
| SupportManagerDepartments::getCloseTicketIntervals | Fetching the ticket intervals from the SupportManagerDepartments model has been changed. | SupportManagerDepartments::getTicketIntervals(30) | 2.14.0 | 3.0 |