# Fortra Automate — Remaining Link Fixes (Handoff)

## What's in this handoff
- **HANDOFF_remaining_work.csv** — 50 remaining link issues across 36 pages, organized by page.

## How to use the CSV
Each row is one link that needs fixing on the live site. Columns:

| Column | Meaning |
|---|---|
| **page_url** | The live page where the bad link appears (open this in a browser to see the link in context) |
| **admin_edit_url** | Drupal admin edit URL — go here directly to fix the link |
| **link_text** | The visible text of the link (use to find it on the page) |
| **link_type** | "Body Content Link" or "CTA Button" — different fix workflows (see below) |
| **current_bad_href** | The current href that needs to be replaced |
| **replacement_url** | What the new href should be |
| **notes** | Why this link is broken and any caveats |

Rows are sorted by `page_url` so all edits for one page are grouped — you can do them all in one editing session.

## Special replacement values
- `REMOVE-LINK-AND-TEXT` — Per client: delete the entire link AND its text (don't just unlink)
- `NEEDS-CLIENT-DECISION` — We don't have a confirmed replacement; ask the client before changing
- `SKIP-PAGE-BEING-HIDDEN` — Client said they're hiding this page; no action needed unless that's not done yet

## How to fix each link type

### Body Content Link
The link is plain HTML in a CKEditor body field. Workflow:
1. Open the **admin_edit_url** in Drupal
2. The page content is in collapsed paragraph sections — click "Edit" on each paragraph until you find the body that contains the link (look for the visible **link_text**)
3. In CKEditor: select the link, click the link tool (chain icon), update the URL to **replacement_url**
4. Save → click "Yes" on the "Publish this?" modal

### CTA Button
The link is in a Drupal Link field (a button styled CTA). This is the tricky one — the URL field uses entity-reference autocomplete and silently reverts plain URL edits. Workflow:
1. Open the **admin_edit_url** in Drupal
2. Find the CTA Group paragraph (look for the matching **link_text** in the "Link text" field)
3. In the **URL** field of the CTA, **clear the existing value**
4. **Type the title of the destination page** (e.g., for /demo, type "Demo" or "Request a Demo")
5. **Wait for the autocomplete dropdown** with matching pages
6. **Click the right entry from the dropdown** — this is critical, it registers the entity selection with Drupal
7. Save → click "Yes" on the "Publish this?" modal
8. Verify by viewing the live page

If you just type the URL and click Save without selecting from the dropdown, Drupal silently keeps the OLD link. This is the bug that broke our automation.

## Stats
- 50 total link fixes across 36 pages
- 26 body content links, 24 CTA buttons
- 38 are straightforward replacements with confirmed targets
- 3 need link + text removed (per client)
- 9 need a fresh client decision before fixing

## What's already been done (for reference)
- All 12 redirect chain flattens
- ~150 body content link updates verified live
- 40+ CTA buttons fixed manually by Rian (these are the ones not in this CSV)
- Master tracking in `master_worklist.csv`

## What's NOT in this CSV
- Items the client has already decided to leave alone (paragraph-types pages, etc.)
- 1-hop redirect cleanups (lower priority — link works for users, just one extra hop. See `reaudit_1hop_redirects.csv` if you want to tackle these later)
- Theme-level menu links (~220 of those one-hops point to `/solutions/automation/robotic-process-automation/hr` and `/homepage` — these are template-level, not body content)