You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: .github/hookdoc-tmpl/README.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -6,8 +6,8 @@ For more information about using ClassifAI with WordPress, please see the [Class
6
6
7
7
To report an issue with ClassifAI or contribute back to the project, please visit the [GitHub repository](https://github.com/10up/classifai/).
8
8
9
-
## Migrating to version 3.0
9
+
## Migrating to version 3.0.0
10
10
11
-
Version 3.0 of ClassifAI contains breaking changes. Please review the [migration guide](./tutorial-migration-guide-v2-to-v3.html)tutorial and follow any steps required.
11
+
Version 3.0.0 of ClassifAI contains breaking changes. Please review the [migration guide](./tutorial-migration-guide-v2-to-v3.html)for an overview of these changes and any action that may be required.
**ClassifAI 3.0** introduces significant improvements and restructuring aimed at enhancing flexibility and extensibility. The key changes include a transition to a "**Feature first**" settings approach, where settings screens are now organized around specific Features rather than Service Providers. This allows for the integration of multiple AI providers for each feature, offering users greater customization options.
1
+
**ClassifAI 3.0.0** introduces significant improvements and restructuring aimed at enhancing flexibility and extensibility. The key changes include a transition to a "**Feature first**" settings approach, where settings screens are now organized around specific Features rather than Service Providers. This allows for the integration of multiple AI providers for each Feature, offering users greater customization options.
2
2
3
-
The migration process is streamlined with an **automated migration routine** that seamlessly transitions your existing settings to the new version upon upgrading to version 3.0.
3
+
This restructuring required a change to how settings are stored. For any existing users of ClassifAI, this means old settings need to be migrated into this new structure. This migration process is streamlined with an **automated migration routine** that seamlessly transitions your existing settings to the new version upon upgrading to version 3.0.0. We recommend that you back up your database prior to upgrading just in case any issues arise during the migration process.
4
4
5
-
This migration guide provides a detailed overview of the changes, including updates to the REST API endpoints and information regarding the removed hooks. Explore the details below to smoothly navigate and leverage the enhanced capabilities of ClassifAI 3.0.
5
+
The rest of this guide provides an overview of the other major changes, including updates to the REST API endpoints and information regarding changes to hooks. If you've customized ClassifAI in any way, these changes may impact those customizations. Explore the details below to smoothly navigate and leverage the enhanced capabilities of ClassifAI 3.0.0.
6
6
7
7
### Provider Class Changes
8
-
In ClassifAI v2, provider classes (such as ChatGPT, ComputerVision, DaLLE, NLU, Whisper, etc.) handled various aspects related to both provider and feature functionalities. This included functionalities such as feature access control, registering feature settings fields, managing provider fields, registering REST API endpoints, connecting to provider services, and exposing in-context features.
9
8
10
-
With the introduction of the "Feature first" approach in ClassifAI 3.0, the provider class has undergone a significant transformation. It is now divided into two distinct classes: Feature and Provider. Consequently, all feature-related functionalities, including feature access control, registering feature settings fields, registering REST API endpoints, and exposing in-context features, have been moved to specific Feature classes. Provider-related tasks remain within the provider classes.
9
+
In ClassifAI v2, Provider classes (such as ChatGPT, ComputerVision, DaLLE, NLU, Whisper, etc.) handled various aspects related to both Provider and Feature functionalities. This included things such as feature access control, registering feature settings fields, managing provider fields, registering REST API endpoints, connecting to provider services, and exposing in-context features.
11
10
12
-
If you have extended any of the Provider classes in your codebase, it is essential to update your code accordingly to align with the changes introduced in ClassifAI 3.0.
11
+
With the introduction of the "Feature first" approach in ClassifAI 3.0.0, the Provider class has undergone a significant transformation. It is now divided into two distinct classes: Feature and Provider. Consequently, all feature-related functionalities, including feature access control, registering feature settings fields, registering REST API endpoints, and exposing in-context features, have been moved to specific Feature classes. Provider-related tasks remain within the provider classes.
13
12
14
-
### REST API Changes
15
-
To standardize the REST API endpoints, we have renamed some of the REST endpoints in ClassifAI 3.0. There are no changes in the request body or parameters. You can find them below.
13
+
If you have extended any of the Provider classes in your codebase, it is essential to update your code accordingly to align with the changes introduced in ClassifAI 3.0.0.
For a detailed look at how new Providers can be added directly to ClassifAI, take a look at these PRs: [#700](https://github.com/10up/classifai/pull/700); [#716](https://github.com/10up/classifai/pull/716). For a detailed look at how a new Feature can be added directly to ClassifAI, take a look at this PR: [#531](https://github.com/10up/classifai/pull/531).
27
16
17
+
### Filter Hook Changes
28
18
29
-
### Filter hooks Changes
30
-
To standardize the action/filter names, we have removed and updated some of the filter hooks in ClassifAI 3.0. You can find them below, along with their replacements.
19
+
To standardize the action/filter names, we have removed and updated some of the filter hooks in ClassifAI 3.0.0. If you've extended ClassifAI at all with the provided hooks, be sure to update those accordingly.
31
20
32
21
| ClassifAI version 2.x | Replacement in ClassifAI version 3.x |
33
22
| --- | --- |
@@ -47,6 +36,21 @@ To standardize the action/filter names, we have removed and updated some of the
47
36
|**`classifai_rest_bases`**|_Removed in ClassifAI 3.0_|
48
37
|**`classifai_should_register_save_post_handler`**|_Removed in ClassifAI 3.0_|
49
38
50
-
Aside from these filter hooks, ClassifAI 3.0 introduces many new actions and filters, which you can find [here](./index.html)
39
+
Aside from these hook changes, ClassifAI 3.0.0 introduces many new actions and filters, which you can find [here](./index.html)
40
+
41
+
### REST API Changes
42
+
43
+
To standardize the REST API endpoints, we have renamed some of the REST endpoints in ClassifAI 3.0.0. There are no changes in the request body or parameters. If you are directly using any of these endpoints, be sure to update those accordingly.
0 commit comments