Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

refactor(unify): §2 — rename WordPress "Projects" → "Pipelines"

Juan Denis8c5763645571
diff --git a/backend/app/__init__.py b/backend/app/__init__.py
index f4665dcc..12154ca8 100644
--- a/backend/app/__init__.py
+++ b/backend/app/__init__.py
@@ -146,6 +146,10 @@ def create_app(config_name=None):
app.register_blueprint(wordpress_bp, url_prefix='/api/v1/wordpress')
app.register_blueprint(wordpress_sites_bp, url_prefix='/api/v1/wordpress')
app.register_blueprint(environment_pipeline_bp, url_prefix='/api/v1/wordpress/projects')
+ # "WordPress Projects" was renamed to "Pipelines" (§2 unification). Mount the
+ # same blueprint under /wordpress/pipelines as a true alias so both URL
+ # spaces resolve identically during the deprecation window.
+ app.register_blueprint(environment_pipeline_bp, url_prefix='/api/v1/wordpress/pipelines', name='environment_pipeline_pipelines')
# Register blueprints - Python
from app.api.python import python_bp
diff --git a/backend/tests/test_wp_pipelines_alias.py b/backend/tests/test_wp_pipelines_alias.py
new file mode 100644
index 00000000..11ee5a0b
--- /dev/null
+++ b/backend/tests/test_wp_pipelines_alias.py
@@ -0,0 +1,27 @@
+"""§2 unification: /api/v1/wordpress/pipelines aliases /wordpress/projects.
+
+"WordPress Projects" was renamed to "Pipelines" to end the collision with the
+generic /projects surface. The environment-pipeline blueprint is mounted under
+both prefixes, so every route resolves identically during the deprecation
+window.
+"""
+
+
+def test_pipelines_alias_matches_projects_list(client, auth_headers):
+ projects_res = client.get('/api/v1/wordpress/projects', headers=auth_headers)
+ pipelines_res = client.get('/api/v1/wordpress/pipelines', headers=auth_headers)
+
+ assert projects_res.status_code == 200
+ assert pipelines_res.status_code == 200
+ assert pipelines_res.get_json() == projects_res.get_json()
+
+
+def test_both_pipeline_prefixes_registered():
+ from app import create_app
+
+ application = create_app('testing')
+ rules = {r.rule for r in application.url_map.iter_rules()}
+ has_projects = any(r.startswith('/api/v1/wordpress/projects') for r in rules)
+ has_pipelines = any(r.startswith('/api/v1/wordpress/pipelines') for r in rules)
+ assert has_projects
+ assert has_pipelines
diff --git a/frontend/src/App.jsx b/frontend/src/App.jsx
index 701babf6..8d8e9c16 100644
--- a/frontend/src/App.jsx
+++ b/frontend/src/App.jsx
@@ -96,7 +96,7 @@ const PAGE_TITLES = {
'/shared-variables': 'Shared Variables',
'/fleet-proxy': 'Fleet Proxy',
'/wordpress': 'WordPress Sites',
- '/wordpress/projects': 'WordPress Projects',
+ '/wordpress/pipelines': 'WordPress Pipelines',
'/templates': 'Templates',
'/deployments': 'Deployment Activity',
'/workflow': 'Workflow Builder',
@@ -158,6 +158,14 @@ function LegacyAppRedirect() {
return <Navigate to={`/services/${suffix}`} replace />;
}
+// "WordPress Projects" was renamed to "Pipelines" (§2 unification) to end the
+// collision with generic /projects. Forward old deep links to the new space.
+function LegacyWpPipelineRedirect() {
+ const { id, tab } = useParams();
+ const suffix = [id, tab].filter(Boolean).join('/');
+ return <Navigate to={`/wordpress/pipelines/${suffix}`} replace />;
+}
+
function PageTitleUpdater() {
const location = useLocation();
const { page_titles: pluginTitles } = useContributions();
@@ -189,7 +197,7 @@ function PageTitleUpdater() {
title = pluginTitles[basePath];
} else if (path.startsWith('/services/')) title = 'Service Details';
else if (path.startsWith('/servers/')) title = 'Server Details';
- else if (path.startsWith('/wordpress/projects/')) title = 'WordPress Pipeline';
+ else if (path.startsWith('/wordpress/pipelines/') || path.startsWith('/wordpress/projects/')) title = 'WordPress Pipeline';
else if (path.startsWith('/wordpress/')) title = 'WordPress Site';
else title = 'ServerKit';
}
@@ -332,10 +340,14 @@ function AppRoutes() {
<Route path="apps/:id/:tab" element={<LegacyAppRedirect />} />
<Route element={<TabGroupLayout tabs={WORDPRESS_TABS} />}>
<Route path="wordpress" element={<WordPress />} />
- <Route path="wordpress/projects" element={<WordPressProjects />} />
+ <Route path="wordpress/pipelines" element={<WordPressProjects />} />
</Route>
- <Route path="wordpress/projects/:id" element={<WordPressProject />} />
- <Route path="wordpress/projects/:id/:tab" element={<WordPressProject />} />
+ <Route path="wordpress/pipelines/:id" element={<WordPressProject />} />
+ <Route path="wordpress/pipelines/:id/:tab" element={<WordPressProject />} />
+ {/* Legacy "WordPress Projects" URLs → Pipelines (§2). */}
+ <Route path="wordpress/projects" element={<Navigate to="/wordpress/pipelines" replace />} />
+ <Route path="wordpress/projects/:id" element={<LegacyWpPipelineRedirect />} />
+ <Route path="wordpress/projects/:id/:tab" element={<LegacyWpPipelineRedirect />} />
<Route path="wordpress/:id" element={<WordPressDetail />} />
<Route path="wordpress/:id/:tab" element={<WordPressDetail />} />
{/* Settings sub-section in the URL (e.g. .../settings/git) so the
diff --git a/frontend/src/components/CommandPalette.jsx b/frontend/src/components/CommandPalette.jsx
index 8529cda9..892ba96c 100644
--- a/frontend/src/components/CommandPalette.jsx
+++ b/frontend/src/components/CommandPalette.jsx
@@ -21,7 +21,7 @@ const STATIC_PAGES = [
{ label: 'Deployments', path: '/deployments', category: 'Pages', keywords: 'deploy jobs status logs' },
{ label: 'Workflow Builder', path: '/workflow', category: 'Pages', keywords: 'automation pipeline' },
{ label: 'WordPress', path: '/wordpress', category: 'Pages', keywords: 'wp sites' },
- { label: 'WordPress Projects', path: '/wordpress/projects', category: 'Pages', keywords: 'wp environments' },
+ { label: 'WordPress Pipelines', path: '/wordpress/pipelines', category: 'Pages', keywords: 'wp environments projects pipeline' },
{ label: 'Files', path: '/files', category: 'Pages', keywords: 'file manager explorer' },
{ label: 'FTP Server', path: '/ftp', category: 'Pages', keywords: 'sftp upload' },
{ label: 'Monitoring', path: '/monitoring', category: 'Pages', keywords: 'metrics uptime' },
diff --git a/frontend/src/components/sidebarItems.js b/frontend/src/components/sidebarItems.js
index f5745dde..47268d4c 100644
--- a/frontend/src/components/sidebarItems.js
+++ b/frontend/src/components/sidebarItems.js
@@ -89,7 +89,8 @@ export const SIDEBAR_ITEMS = [
{
// Redesign: WordPress uses the top-bar layout (REDESIGN_MAP §6 dec. 3).
// Pipeline now lives in the page's top bar (PageTopbar WORDPRESS_TABS),
- // not as a sidebar sub-item. Route /wordpress/projects is unchanged.
+ // not as a sidebar sub-item. The pipeline list is at /wordpress/pipelines
+ // (renamed from /wordpress/projects in §2; old URLs redirect).
id: 'wordpress',
label: 'WordPress',
route: '/wordpress',
diff --git a/frontend/src/components/wordpress/wordpressTabs.jsx b/frontend/src/components/wordpress/wordpressTabs.jsx
index 784e4cd7..f47623b9 100644
--- a/frontend/src/components/wordpress/wordpressTabs.jsx
+++ b/frontend/src/components/wordpress/wordpressTabs.jsx
@@ -7,5 +7,5 @@ import { Globe, GitBranch } from 'lucide-react';
// here for simplicity — the pipeline page shows an empty state when unused.)
export const WORDPRESS_TABS = [
{ to: '/wordpress', label: 'WordPress', end: true, icon: <Globe size={15} /> },
- { to: '/wordpress/projects', label: 'Pipeline', icon: <GitBranch size={15} /> },
+ { to: '/wordpress/pipelines', label: 'Pipeline', icon: <GitBranch size={15} /> },
];
diff --git a/frontend/src/pages/WordPressProject.jsx b/frontend/src/pages/WordPressProject.jsx
index 6c11b46d..8a942d67 100644
--- a/frontend/src/pages/WordPressProject.jsx
+++ b/frontend/src/pages/WordPressProject.jsx
@@ -40,7 +40,7 @@ const WordPressProject = () => {
const [pipeline, setPipeline] = useState(null);
const [loading, setLoading] = useState(true);
- const [activeTab, setActiveTab] = useTabParam(`/wordpress/projects/${id}`, VALID_TABS);
+ const [activeTab, setActiveTab] = useTabParam(`/wordpress/pipelines/${id}`, VALID_TABS);
const [showCreateEnvModal, setShowCreateEnvModal] = useState(false);
const [promoteModal, setPromoteModal] = useState(null);
const [syncModal, setSyncModal] = useState(null);
@@ -405,9 +405,9 @@ const WordPressProject = () => {
return (
<EmptyState
icon={FolderGit2}
- title="Project not found"
- description="This WordPress project does not exist or has been removed."
- action={<Button onClick={() => navigate('/wordpress/projects')}>Back to Projects</Button>}
+ title="Pipeline not found"
+ description="This WordPress pipeline does not exist or has been removed."
+ action={<Button onClick={() => navigate('/wordpress/pipelines')}>Back to Pipelines</Button>}
/>
);
}
@@ -421,7 +421,7 @@ const WordPressProject = () => {
{/* Top Bar */}
<div className="app-detail-topbar">
<div className="app-detail-breadcrumbs">
- <Link to="/wordpress/projects">Projects</Link>
+ <Link to="/wordpress/pipelines">Pipelines</Link>
<span>/</span>
<span className="current">{projectName}</span>
</div>
diff --git a/frontend/src/pages/WordPressProjects.jsx b/frontend/src/pages/WordPressProjects.jsx
index ca794101..eb2d23e4 100644
--- a/frontend/src/pages/WordPressProjects.jsx
+++ b/frontend/src/pages/WordPressProjects.jsx
@@ -19,7 +19,7 @@ const WordPressProjects = () => {
async function loadProjects() {
setLoading(true);
try {
- const data = await wordpressApi.getProjects();
+ const data = await wordpressApi.getPipelines();
setProjects(data.projects || []);
} catch (err) {
console.error('Failed to load projects:', err);
@@ -30,7 +30,7 @@ const WordPressProjects = () => {
}
if (loading) {
- return <EmptyState loading size="lg" title="Loading WordPress projects" />;
+ return <EmptyState loading size="lg" title="Loading WordPress pipelines" />;
}
return (
@@ -39,8 +39,8 @@ const WordPressProjects = () => {
<EmptyState
size="lg"
icon={Layers}
- title="No WordPress Projects"
- description="WordPress projects with environment pipelines appear here. Create a WordPress site with environments enabled to get started."
+ title="No WordPress Pipelines"
+ description="WordPress sites with environment pipelines appear here. Create a WordPress site with environments enabled to get started."
/>
) : (
<div className="wp-projects-grid">
@@ -48,7 +48,7 @@ const WordPressProjects = () => {
<ProjectCard
key={project.id}
project={project}
- onClick={() => navigate(`/wordpress/projects/${project.id}`)}
+ onClick={() => navigate(`/wordpress/pipelines/${project.id}`)}
/>
))}
</div>
diff --git a/frontend/src/services/wordpress.js b/frontend/src/services/wordpress.js
index d9f44f01..5d023eca 100644
--- a/frontend/src/services/wordpress.js
+++ b/frontend/src/services/wordpress.js
@@ -272,7 +272,10 @@ const wordpressApi = {
// =========================================
PIPELINE_PATH: '/wordpress/projects',
- // Project listing
+ // Pipeline listing. "Pipelines" is the user-facing term (§2); getProjects
+ // is kept as a back-compat alias. Both hit the canonical backend route,
+ // which is also mounted at /wordpress/pipelines.
+ getPipelines: () => api.request('/wordpress/projects'),
getProjects: () => api.request('/wordpress/projects'),
// Pipeline dashboard