Skip to content

Commit ec2f63c

Browse files
committed
add credentials documentation
1 parent 2de57b7 commit ec2f63c

File tree

1 file changed

+31
-2
lines changed

1 file changed

+31
-2
lines changed

docs/USER_GUIDE.md

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,36 @@ The component will automatically create the required database tables upon instal
4444
- **URL**: Base URL of the source CMS
4545
- **Credentials**: API keys or authentication details
4646

47-
### 2. Running a Migration
47+
### 2. Obtaining CMS Credentials
48+
49+
Before you can migrate content, you need to obtain the proper API credentials for each CMS:
50+
51+
#### For WordPress
52+
1. **Install WordPress REST API Plugin** (if not already available):
53+
- Go to your WordPress admin panel
54+
- Navigate to **Plugins > Add New**
55+
- Search for "Application Passwords" or "REST API Authentication"
56+
- Install and activate the plugin
57+
58+
2. **Generate Application Password**:
59+
- Go to **Users > Profile** in WordPress admin
60+
- Scroll down to **Application Passwords** section
61+
- Enter a name for the application (e.g., "CCM Migration")
62+
- Click **Add New Application Password**
63+
- Copy the generated password (it won't be shown again)
64+
65+
#### For Joomla
66+
1. **Create API Token**:
67+
- Go to **System > Manage > API Tokens**
68+
- Click **New** to create a new token
69+
- Enter a **Title** for the token
70+
- Select appropriate **User** (should have necessary permissions)
71+
- Click **Save**
72+
- Copy the generated token
73+
74+
> **Security Note**: Always use dedicated API credentials with minimal required permissions. Never use your main administrator password for API access.
75+
76+
### 3. Running a Migration
4877

4978
1. Navigate to **Components > CCM > Migration**
5079
2. Select source and target CMS
@@ -59,7 +88,7 @@ The component will automatically create the required database tables upon instal
5988
4. Click **Apply Migration**
6089
5. Monitor progress in real-time
6190

62-
### 3. Migration Process
91+
### 4. Migration Process
6392

6493
The migration follows these steps:
6594

0 commit comments

Comments
 (0)