Skip to content

armgit / dub

Public Imported from GitHub
0

The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.

add partner link titles and private comments

Pedro Ladeira4186ac411bc1
diff --git a/apps/web/app/(ee)/api/partner-profile/programs/[programId]/customers/count/route.ts b/apps/web/app/(ee)/api/partner-profile/programs/[programId]/customers/count/route.ts
index e6b2eb963d..9941c8cb14 100644
--- a/apps/web/app/(ee)/api/partner-profile/programs/[programId]/customers/count/route.ts
+++ b/apps/web/app/(ee)/api/partner-profile/programs/[programId]/customers/count/route.ts
@@ -103,6 +103,7 @@ export const GET = withPartnerProfile(
key: true,
shortLink: true,
url: true,
+ partnerLinkTitle: true,
},
});
@@ -116,6 +117,7 @@ export const GET = withPartnerProfile(
key: link.key,
shortLink: link.shortLink,
url: link.url,
+ partnerLinkTitle: link?.partnerLinkTitle,
};
})
.filter(Boolean);
diff --git a/apps/web/app/(ee)/api/partner-profile/programs/[programId]/earnings/count/route.ts b/apps/web/app/(ee)/api/partner-profile/programs/[programId]/earnings/count/route.ts
index ce4a31c8f2..ca472458f6 100644
--- a/apps/web/app/(ee)/api/partner-profile/programs/[programId]/earnings/count/route.ts
+++ b/apps/web/app/(ee)/api/partner-profile/programs/[programId]/earnings/count/route.ts
@@ -86,6 +86,7 @@ export const GET = withPartnerProfile(
domain: link?.domain,
key: link?.key,
url: link?.url,
+ partnerLinkTitle: link?.partnerLinkTitle,
_count,
};
}) as any[]; // TODO: find a better fix for types
diff --git a/apps/web/app/(ee)/api/partner-profile/programs/[programId]/links/[linkId]/route.ts b/apps/web/app/(ee)/api/partner-profile/programs/[programId]/links/[linkId]/route.ts
index 0fcfafa048..b9a2b51d74 100644
--- a/apps/web/app/(ee)/api/partner-profile/programs/[programId]/links/[linkId]/route.ts
+++ b/apps/web/app/(ee)/api/partner-profile/programs/[programId]/links/[linkId]/route.ts
@@ -15,9 +15,15 @@ import { NextResponse } from "next/server";
// PATCH /api/partner-profile/[programId]/links/[linkId] - update a link for a partner
export const PATCH = withPartnerProfile(
async ({ partner, params, req, session }) => {
- const { url, key, comments } = createPartnerLinkSchema
- .pick({ url: true, key: true, comments: true })
- .parse(await parseRequestBody(req));
+ const { url, key, partnerLinkTitle, partnerLinkComments } =
+ createPartnerLinkSchema
+ .pick({
+ url: true,
+ key: true,
+ partnerLinkTitle: true,
+ partnerLinkComments: true,
+ })
+ .parse(await parseRequestBody(req));
const { programId, linkId } = params;
@@ -121,7 +127,8 @@ export const PATCH = withPartnerProfile(
// merge in new props
key: key || undefined,
url: url || program.url,
- comments,
+ partnerLinkTitle,
+ partnerLinkComments,
},
workspace: {
id: program.workspaceId,
diff --git a/apps/web/app/(ee)/api/partner-profile/programs/[programId]/links/route.ts b/apps/web/app/(ee)/api/partner-profile/programs/[programId]/links/route.ts
index fb1f32983d..139cfb3537 100644
--- a/apps/web/app/(ee)/api/partner-profile/programs/[programId]/links/route.ts
+++ b/apps/web/app/(ee)/api/partner-profile/programs/[programId]/links/route.ts
@@ -47,9 +47,15 @@ export const GET = withPartnerProfile(async ({ partner, params }) => {
// POST /api/partner-profile/[programId]/links - create a link for a partner
export const POST = withPartnerProfile(
async ({ partner, params, req, session }) => {
- const { url, key, comments } = createPartnerLinkSchema
- .pick({ url: true, key: true, comments: true })
- .parse(await parseRequestBody(req));
+ const { url, key, partnerLinkTitle, partnerLinkComments } =
+ createPartnerLinkSchema
+ .pick({
+ url: true,
+ key: true,
+ partnerLinkTitle: true,
+ partnerLinkComments: true,
+ })
+ .parse(await parseRequestBody(req));
const {
program,
@@ -125,7 +131,8 @@ export const POST = withPartnerProfile(
tenantId,
partnerId: partner.id,
folderId: program.defaultFolderId,
- comments,
+ partnerLinkTitle,
+ partnerLinkComments,
trackConversion: true,
},
workspace: {
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/customers/(index)/page.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/customers/(index)/page.tsx
index 6b4ba8dcfd..17ae4f5003 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/customers/(index)/page.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/customers/(index)/page.tsx
@@ -3,6 +3,7 @@
import { PARTNER_CUSTOMERS_MAX_PAGE_SIZE } from "@/lib/constants/partner-profile";
import usePartnerCustomers from "@/lib/swr/use-partner-customers";
import usePartnerCustomersCount from "@/lib/swr/use-partner-customers-count";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import useProgramEnrollment from "@/lib/swr/use-program-enrollment";
import { CustomerRowItem } from "@/ui/customers/customer-row-item";
import { AnimatedEmptyState } from "@/ui/shared/animated-empty-state";
@@ -32,6 +33,7 @@ export default function PartnerProgramCustomersPage() {
const { programSlug } = useParams<{ programSlug: string }>();
const { programEnrollment } = useProgramEnrollment();
+ const { preferTitle } = usePartnerLinksDisplay();
const { data: customersCount, error: countError } =
usePartnerCustomersCount();
@@ -126,9 +128,15 @@ export default function PartnerProgramCustomersPage() {
/>
<span
className="truncate"
- title={row.original.activity.link.shortLink}
+ title={
+ preferTitle && row.original.activity.link.partnerLinkTitle
+ ? row.original.activity.link.partnerLinkTitle
+ : row.original.activity.link.shortLink
+ }
>
- {getPrettyUrl(row.original.activity.link.shortLink)}
+ {preferTitle && row.original.activity.link.partnerLinkTitle
+ ? row.original.activity.link.partnerLinkTitle
+ : getPrettyUrl(row.original.activity.link.shortLink)}
</span>
</a>
) : (
@@ -209,7 +217,7 @@ export default function PartnerProgramCustomersPage() {
header: () => <EditColumnsButton table={table} />,
},
].filter((c) => c.id === "menu" || customersColumns.all.includes(c.id)),
- [programSlug],
+ [programSlug, preferTitle],
);
const { table, ...tableProps } = useTable({
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/customers/(index)/use-partner-customer-filters.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/customers/(index)/use-partner-customer-filters.tsx
index 8a8be3fd8e..a1fdf78af6 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/customers/(index)/use-partner-customer-filters.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/customers/(index)/use-partner-customer-filters.tsx
@@ -1,4 +1,5 @@
import usePartnerCustomersCount from "@/lib/swr/use-partner-customers-count";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import { CountryFlag } from "@/ui/shared/country-flag";
import { useRouterStuff } from "@dub/ui";
import { Globe, Hyperlink } from "@dub/ui/icons";
@@ -8,6 +9,7 @@ import { useCallback, useMemo, useState } from "react";
export function usePartnerCustomerFilters() {
const { searchParamsObj, queryParams } = useRouterStuff();
const [selectedFilter, setSelectedFilter] = useState<string | null>(null);
+ const { preferTitle } = usePartnerLinksDisplay();
const { data: countriesCount } = usePartnerCustomersCount<
| {
@@ -28,6 +30,7 @@ export function usePartnerCustomerFilters() {
domain: string;
key: string;
shortLink: string;
+ partnerLinkTitle?: string | null;
_count: number;
}[]
| undefined
@@ -55,15 +58,20 @@ export function usePartnerCustomerFilters() {
icon: Hyperlink,
label: "Link",
options:
- linksCount?.map(({ linkId, domain, key, shortLink, _count }) => ({
- value: linkId,
- label: linkConstructor({ domain, key, pretty: true }),
- data: { shortLink },
- right: nFormatter(_count, { full: true }),
- })) ?? null,
+ linksCount?.map(
+ ({ linkId, domain, key, shortLink, partnerLinkTitle, _count }) => ({
+ value: linkId,
+ label:
+ preferTitle && partnerLinkTitle
+ ? partnerLinkTitle
+ : linkConstructor({ domain, key, pretty: true }),
+ data: { shortLink },
+ right: nFormatter(_count, { full: true }),
+ }),
+ ) ?? null,
},
],
- [countriesCount, linksCount],
+ [countriesCount, linksCount, preferTitle],
);
const activeFilters = useMemo(() => {
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-composite-chart.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-composite-chart.tsx
index 26b7fc6ec0..f45f016256 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-composite-chart.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-composite-chart.tsx
@@ -6,6 +6,7 @@ import { IntervalOptions } from "@/lib/analytics/types";
import usePartnerEarningsCount from "@/lib/swr/use-partner-earnings-count";
import { usePartnerEarningsTimeseries } from "@/lib/swr/use-partner-earnings-timeseries";
import usePartnerLinks from "@/lib/swr/use-partner-links";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import { LinkIcon } from "@/ui/links/link-icon";
import { CommissionTypeIcon } from "@/ui/partners/comission-type-icon";
import { CommissionStatusBadges } from "@/ui/partners/commission-status-badges";
@@ -61,6 +62,7 @@ export function EarningsCompositeChart() {
};
const { links } = usePartnerLinks();
+ const { preferTitle } = usePartnerLinksDisplay();
const { data } = usePartnerEarningsTimeseries({
interval,
@@ -208,9 +210,11 @@ export function EarningsCompositeChart() {
)}
/>
<span className="min-w-0 truncate font-medium text-neutral-700">
- {link?.shortLink
- ? getPrettyUrl(link.shortLink)
- : capitalize(id)}
+ {preferTitle && link?.partnerLinkTitle
+ ? link.partnerLinkTitle
+ : link?.shortLink
+ ? getPrettyUrl(link.shortLink)
+ : capitalize(id)}
</span>
</div>
<p className="text-right text-neutral-500">
@@ -253,9 +257,17 @@ export function EarningsCompositeChart() {
function EarningsTableControls() {
const { queryParams, searchParamsObj } = useRouterStuff();
const [selectedFilter, setSelectedFilter] = useState<string | null>(null);
+ const { preferTitle } = usePartnerLinksDisplay();
const { earningsCount: links } = usePartnerEarningsCount<
- { id: string; domain: string; key: string; url: string; _count: number }[]
+ {
+ id: string;
+ domain: string;
+ key: string;
+ url: string;
+ partnerLinkTitle?: string | null;
+ _count: number;
+ }[]
>({
groupBy: "linkId",
enabled:
@@ -300,13 +312,16 @@ function EarningsTableControls() {
return <LinkIcon url={props.option?.data?.url} />;
},
options:
- links?.map(({ id, domain, key, url }) => ({
+ links?.map(({ id, domain, key, url, partnerLinkTitle }) => ({
value: id,
- label: linkConstructor({
- domain,
- key,
- pretty: true,
- }),
+ label:
+ preferTitle && partnerLinkTitle
+ ? partnerLinkTitle
+ : linkConstructor({
+ domain,
+ key,
+ pretty: true,
+ }),
data: { url },
})) ?? null,
},
@@ -342,7 +357,7 @@ function EarningsTableControls() {
}),
},
],
- [links, customers, statuses],
+ [links, customers, statuses, preferTitle],
);
const activeFilters = useMemo(() => {
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-table.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-table.tsx
index 2ce16ea3b2..ad60ba014b 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-table.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-table.tsx
@@ -1,6 +1,7 @@
"use client";
import usePartnerEarningsCount from "@/lib/swr/use-partner-earnings-count";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import usePartnerProfile from "@/lib/swr/use-partner-profile";
import useProgramEnrollment from "@/lib/swr/use-program-enrollment";
import { PartnerEarningsResponse } from "@/lib/types";
@@ -48,6 +49,7 @@ export function EarningsTablePartner({ limit }: { limit?: number }) {
const { partner } = usePartnerProfile();
const { programEnrollment, showDetailedAnalytics } = useProgramEnrollment();
const { queryParams, searchParamsObj, getQueryString } = useRouterStuff();
+ const { preferTitle } = usePartnerLinksDisplay();
const { sortBy = "createdAt", sortOrder = "desc" } = searchParamsObj as {
sortBy?: "createdAt";
@@ -113,15 +115,23 @@ export function EarningsTablePartner({ limit }: { limit?: number }) {
row.original.link ? { linkId: row.original.link.id } : null,
},
cell: ({ row }) => {
- const referralLink = row.original.link
+ const link = row.original.link;
+ const referralLink = link
? {
- apexDomain: getApexDomain(row.original.link.url),
- shortLink: row.original.link.shortLink,
+ apexDomain: getApexDomain(link.url),
+ shortLink: link.shortLink,
+ label:
+ preferTitle && link.partnerLinkTitle
+ ? link.partnerLinkTitle
+ : getPrettyUrl(link.shortLink),
}
: row.original.type === CommissionType.referral && partner?.username
? {
apexDomain: "dub.co",
shortLink: `https://partners.dub.co/${programSlug}/apply?via=${partner.username}`,
+ label: getPrettyUrl(
+ `https://partners.dub.co/${programSlug}/apply?via=${partner.username}`,
+ ),
}
: null;
@@ -138,8 +148,8 @@ export function EarningsTablePartner({ limit }: { limit?: number }) {
successMessage="Copied link to clipboard!"
className="truncate"
>
- <span className="truncate" title={referralLink.shortLink}>
- {getPrettyUrl(referralLink.shortLink)}
+ <span className="truncate" title={referralLink.label}>
+ {referralLink.label}
</span>
</CopyText>
</div>
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/page-client.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/page-client.tsx
index 5132e3823c..0ffeabaabd 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/page-client.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/page-client.tsx
@@ -6,21 +6,17 @@ import {
} from "@/lib/analytics/constants";
import { IntervalOptions } from "@/lib/analytics/types";
import usePartnerLinks from "@/lib/swr/use-partner-links";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import useProgramEnrollment from "@/lib/swr/use-program-enrollment";
import { usePartnerLinkModal } from "@/ui/modals/partner-link-modal";
import { AnimatedEmptyState } from "@/ui/shared/animated-empty-state";
import SimpleDateRangePicker from "@/ui/shared/simple-date-range-picker";
-import {
- Button,
- CardList,
- ToggleGroup,
- useKeyboardShortcut,
- useRouterStuff,
-} from "@dub/ui";
+import { Button, CardList, useKeyboardShortcut, useRouterStuff } from "@dub/ui";
import { ChartTooltipSync } from "@dub/ui/charts";
-import { CursorRays, GridIcon, GridLayoutRows, Hyperlink } from "@dub/ui/icons";
-import { createContext, useContext, useEffect, useState } from "react";
+import { CursorRays, Hyperlink } from "@dub/ui/icons";
+import { createContext, useContext, useState } from "react";
import { PartnerLinkCard } from "./partner-link-card";
+import { PartnerLinkDisplay } from "./partner-link-display";
const PartnerLinksContext = createContext<{
start?: Date;
@@ -28,7 +24,7 @@ const PartnerLinksContext = createContext<{
interval: (typeof DATE_RANGE_INTERVAL_PRESETS)[number];
openMenuLinkId: string | null;
setOpenMenuLinkId: (id: string | null) => void;
- displayOption: "full" | "cards";
+ viewMode: "cards" | "rows";
} | null>(null);
export function usePartnerLinksContext() {
@@ -48,15 +44,10 @@ export function PartnerProgramLinksPageClient() {
const { setShowPartnerLinkModal, PartnerLinkModal } = usePartnerLinkModal();
const [openMenuLinkId, setOpenMenuLinkId] = useState<string | null>(null);
- const [displayOption, setDisplayOption] = useState<"full" | "cards">("full");
-
- useEffect(() => {
- if ((links && links.length > 5) || !showDetailedAnalytics) {
- setDisplayOption("cards");
- } else {
- setDisplayOption("full");
- }
- }, [links, showDetailedAnalytics]);
+ const { viewMode } = usePartnerLinksDisplay({
+ linksCount: links?.length,
+ showDetailedAnalytics,
+ });
const {
start,
@@ -83,7 +74,7 @@ export function PartnerProgramLinksPageClient() {
});
const showAllTimeAnalytics =
- !showDetailedAnalytics || displayOption === "cards";
+ !showDetailedAnalytics || viewMode === "rows";
return (
<div className="flex flex-col gap-4">
@@ -98,35 +89,7 @@ export function PartnerProgramLinksPageClient() {
disabled={showAllTimeAnalytics}
/>
<div className="flex items-center gap-3">
- {!!showDetailedAnalytics && (
- <ToggleGroup
- className="h-10 rounded-lg px-1"
- optionClassName="px-2 rounded-md"
- indicatorClassName="border-0 ring-1 ring-inset ring-neutral-200"
- options={[
- {
- value: "full",
- label: (
- <div className="p-1">
- <GridIcon className="size-4" />
- </div>
- ),
- },
- {
- value: "cards",
- label: (
- <div className="p-1">
- <GridLayoutRows className="size-4" />
- </div>
- ),
- },
- ]}
- selected={displayOption}
- selectAction={(option) =>
- setDisplayOption(option as "full" | "cards")
- }
- />
- )}
+ <PartnerLinkDisplay linksCount={links?.length} />
<Button
text="Create Link"
className="w-fit"
@@ -152,7 +115,7 @@ export function PartnerProgramLinksPageClient() {
interval,
openMenuLinkId,
setOpenMenuLinkId,
- displayOption,
+ viewMode,
}}
>
<ChartTooltipSync>
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/partner-link-card.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/partner-link-card.tsx
index 9bb044a58c..158d1b7f5b 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/partner-link-card.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/partner-link-card.tsx
@@ -1,6 +1,7 @@
import { formatDateTooltip } from "@/lib/analytics/format-date-tooltip";
import { constructPartnerLink } from "@/lib/partners/construct-partner-link";
import usePartnerAnalytics from "@/lib/swr/use-partner-analytics";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import useProgramEnrollment from "@/lib/swr/use-program-enrollment";
import { PartnerProfileLinkProps } from "@/lib/types";
import { CommentsBadge } from "@/ui/links/comments-badge";
@@ -67,7 +68,8 @@ const CHARTS = [
export function PartnerLinkCard({ link }: { link: PartnerProfileLinkProps }) {
const { programEnrollment } = useProgramEnrollment();
- const { displayOption } = usePartnerLinksContext();
+ const { viewMode } = usePartnerLinksContext();
+ const { preferTitle } = usePartnerLinksDisplay();
const partnerLink = constructPartnerLink({
group: programEnrollment?.group,
@@ -75,6 +77,7 @@ export function PartnerLinkCard({ link }: { link: PartnerProfileLinkProps }) {
});
const isDeactivated = programEnrollment?.status === "deactivated";
+ const showTitle = preferTitle && Boolean(link.partnerLinkTitle);
const discountCodeSection = link.discountCode ? (
<div className="hidden items-center gap-1.5 rounded-xl border border-neutral-200 py-1 pl-2 pr-1 sm:flex">
@@ -111,44 +114,78 @@ export function PartnerLinkCard({ link }: { link: PartnerProfileLinkProps }) {
<div className="flex min-w-0 flex-col">
<div className="flex flex-col">
<div className="flex items-center gap-1">
- <a
- href={isDeactivated ? undefined : partnerLink}
- target="_blank"
- rel="noopener noreferrer"
- className={cn(
- "truncate text-sm font-semibold leading-6 transition-colors",
- isDeactivated
- ? "cursor-default text-neutral-400"
- : "text-neutral-700 hover:text-black",
- )}
- onClick={
- isDeactivated ? (e) => e.preventDefault() : undefined
- }
- >
- {getPrettyUrl(partnerLink)}
- </a>
+ {showTitle ? (
+ <span
+ className={cn(
+ "truncate text-sm font-semibold leading-6",
+ isDeactivated ? "text-neutral-400" : "text-neutral-700",
+ )}
+ title={link.partnerLinkTitle ?? undefined}
+ >
+ {link.partnerLinkTitle}
+ </span>
+ ) : (
+ <a
+ href={isDeactivated ? undefined : partnerLink}
+ target="_blank"
+ rel="noopener noreferrer"
+ className={cn(
+ "truncate text-sm font-semibold leading-6 transition-colors",
+ isDeactivated
+ ? "cursor-default text-neutral-400"
+ : "text-neutral-700 hover:text-black",
+ )}
+ onClick={
+ isDeactivated ? (e) => e.preventDefault() : undefined
+ }
+ >
+ {getPrettyUrl(partnerLink)}
+ </a>
+ )}
{!isDeactivated && (
<CopyButton value={partnerLink} variant="neutral" />
)}
- {link.comments && <CommentsBadge comments={link.comments} />}
+ {link.partnerLinkComments && (
+ <CommentsBadge comments={link.partnerLinkComments} />
+ )}
</div>
{/* The max width implementation here is a bit hacky, we should improve in the future */}
<div className="flex max-w-[100px] items-center gap-1 py-0 pl-1 pr-1.5 sm:w-fit sm:max-w-[400px]">
<ArrowTurnRight2 className="h-3 w-3 shrink-0 text-neutral-400" />
- <a
- href={isDeactivated ? undefined : link.url}
- target="_blank"
- rel="noopener noreferrer"
- className="cursor-alias truncate text-sm text-neutral-500 decoration-dotted transition-colors hover:text-neutral-700 hover:underline hover:underline-offset-2"
- title={getPrettyUrl(link.url)}
- onClick={
- isDeactivated ? (e) => e.preventDefault() : undefined
- }
- >
- {getPrettyUrl(link.url)}
- </a>
+ {showTitle ? (
+ <a
+ href={isDeactivated ? undefined : partnerLink}
+ target="_blank"
+ rel="noopener noreferrer"
+ className={cn(
+ "truncate text-sm transition-colors",
+ isDeactivated
+ ? "cursor-default text-neutral-400"
+ : "text-neutral-500 hover:text-neutral-700 hover:underline hover:underline-offset-2",
+ )}
+ title={getPrettyUrl(partnerLink)}
+ onClick={
+ isDeactivated ? (e) => e.preventDefault() : undefined
+ }
+ >
+ {getPrettyUrl(partnerLink)}
+ </a>
+ ) : (
+ <a
+ href={isDeactivated ? undefined : link.url}
+ target="_blank"
+ rel="noopener noreferrer"
+ className="cursor-alias truncate text-sm text-neutral-500 decoration-dotted transition-colors hover:text-neutral-700 hover:underline hover:underline-offset-2"
+ title={getPrettyUrl(link.url)}
+ onClick={
+ isDeactivated ? (e) => e.preventDefault() : undefined
+ }
+ >
+ {getPrettyUrl(link.url)}
+ </a>
+ )}
</div>
</div>
</div>
@@ -175,12 +212,12 @@ export function PartnerLinkCard({ link }: { link: PartnerProfileLinkProps }) {
{discountCodeSection}
</Tooltip>
))}
- {displayOption === "cards" && <StatsBadge link={link} />}
+ {viewMode === "rows" && <StatsBadge link={link} />}
<Controls link={link} />
</div>
</div>
</div>
- {displayOption === "full" && <StatsCharts link={link} />}
+ {viewMode === "cards" && <StatsCharts link={link} />}
</CardList.Card>
);
}
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/partner-link-display.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/partner-link-display.tsx
new file mode 100644
index 0000000000..c65a1c7523
--- /dev/null
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/links/partner-link-display.tsx
@@ -0,0 +1,114 @@
+"use client";
+
+import {
+ PartnerLinksViewMode,
+ usePartnerLinksDisplay,
+} from "@/lib/swr/use-partner-links-display";
+import useProgramEnrollment from "@/lib/swr/use-program-enrollment";
+import { Button, Popover } from "@dub/ui";
+import { GridLayoutRows, Sliders, TableRows2 } from "@dub/ui/icons";
+import { cn } from "@dub/utils";
+import { ChevronDown } from "lucide-react";
+import { useState } from "react";
+
+const DISPLAY_PROPERTIES = [
+ { id: "link" as const, label: "Short link" },
+ { id: "title" as const, label: "Title" },
+];
+
+export function PartnerLinkDisplay({ linksCount }: { linksCount?: number }) {
+ const { showDetailedAnalytics } = useProgramEnrollment();
+ const { preferTitle, setPreferTitle, viewMode, setViewMode } =
+ usePartnerLinksDisplay({
+ linksCount,
+ showDetailedAnalytics,
+ });
+ const [openPopover, setOpenPopover] = useState(false);
+
+ return (
+ <Popover
+ content={
+ <div className="w-full divide-y divide-neutral-200 text-sm md:w-80">
+ {!!showDetailedAnalytics && (
+ <div className="grid grid-cols-2 gap-2 p-3">
+ {[
+ { id: "cards" as const, label: "Cards", icon: GridLayoutRows },
+ { id: "rows" as const, label: "Rows", icon: TableRows2 },
+ ].map(({ id, label, icon: Icon }) => {
+ const selected = viewMode === id;
+ return (
+ <button
+ key={id}
+ type="button"
+ className={cn(
+ "flex h-16 flex-col items-center justify-center gap-1 rounded-md border border-transparent transition-colors",
+ selected
+ ? "border-neutral-300 bg-neutral-100 text-neutral-950"
+ : "text-neutral-800 hover:bg-neutral-100 hover:text-neutral-950",
+ )}
+ onClick={() => setViewMode(id as PartnerLinksViewMode)}
+ aria-pressed={selected}
+ >
+ <Icon
+ className={cn(
+ "h-5 w-5 text-neutral-600",
+ selected && "text-neutral-800",
+ )}
+ />
+ {label}
+ </button>
+ );
+ })}
+ </div>
+ )}
+ <div className="p-4">
+ <span className="text-xs uppercase text-neutral-500">
+ Display Properties
+ </span>
+ <div className="mt-4 flex flex-wrap gap-2">
+ {DISPLAY_PROPERTIES.map((property) => {
+ const active =
+ property.id === "title" ? preferTitle : !preferTitle;
+ return (
+ <button
+ key={property.id}
+ type="button"
+ aria-pressed={active}
+ onClick={() => setPreferTitle(property.id === "title")}
+ className={cn(
+ "rounded-md border px-2 py-0.5 text-sm",
+ active
+ ? "border-neutral-300 bg-neutral-100 text-neutral-950"
+ : "border-transparent text-neutral-600 hover:bg-neutral-100 hover:text-neutral-950",
+ )}
+ >
+ {property.label}
+ </button>
+ );
+ })}
+ </div>
+ </div>
+ </div>
+ }
+ openPopover={openPopover}
+ setOpenPopover={setOpenPopover}
+ >
+ <Button
+ variant="secondary"
+ className="hover:bg-white [&>div]:w-full"
+ textWrapperClassName="!overflow-visible"
+ text={
+ <div className="flex w-full items-center gap-2">
+ <Sliders className="h-4 w-4 shrink-0" />
+ <span className="grow text-left">Display</span>
+ <ChevronDown
+ className={cn("h-4 w-4 text-neutral-400 transition-transform", {
+ "rotate-180": openPopover,
+ })}
+ />
+ </div>
+ }
+ />
+ </Popover>
+ );
+}
diff --git a/apps/web/lib/analytics/get-analytics.ts b/apps/web/lib/analytics/get-analytics.ts
index 2ea19ff6ae..2e89b07d08 100644
--- a/apps/web/lib/analytics/get-analytics.ts
+++ b/apps/web/lib/analytics/get-analytics.ts
@@ -217,6 +217,7 @@ export const getAnalytics = async (params: AnalyticsFilters) => {
key: true,
url: true,
title: true,
+ partnerLinkTitle: true,
comments: true,
folderId: true,
partnerId: true,
diff --git a/apps/web/lib/api/links/create-link.ts b/apps/web/lib/api/links/create-link.ts
index f5b2e9ec57..5453a125f5 100644
--- a/apps/web/lib/api/links/create-link.ts
+++ b/apps/web/lib/api/links/create-link.ts
@@ -60,6 +60,9 @@ export async function createLink(link: ProcessedLinkProps) {
shortLink: linkConstructorSimple({ domain: link.domain, key }),
title: truncate(title, 120),
description: truncate(description, 240),
+ partnerLinkTitle: rest.partnerLinkTitle
+ ? truncate(rest.partnerLinkTitle, 120)
+ : rest.partnerLinkTitle,
// if it's an uploaded image, make this null first because we'll update it later
image: proxy && image && isNotHostedImage(image) ? null : image,
utm_source,
diff --git a/apps/web/lib/api/links/update-link.ts b/apps/web/lib/api/links/update-link.ts
index 6f19f679f8..c0efcaa0c7 100644
--- a/apps/web/lib/api/links/update-link.ts
+++ b/apps/web/lib/api/links/update-link.ts
@@ -91,6 +91,9 @@ export async function updateLink({
}),
title: truncate(title, 120),
description: truncate(description, 240),
+ partnerLinkTitle: rest.partnerLinkTitle
+ ? truncate(rest.partnerLinkTitle, 120)
+ : rest.partnerLinkTitle,
image:
proxy && image && isNotHostedImage(image)
? `${R2_URL}/images/${id}_${imageUrlNonce}`
diff --git a/apps/web/lib/swr/use-partner-links-display.ts b/apps/web/lib/swr/use-partner-links-display.ts
new file mode 100644
index 0000000000..c5cd1736c3
--- /dev/null
+++ b/apps/web/lib/swr/use-partner-links-display.ts
@@ -0,0 +1,41 @@
+"use client";
+
+import { useSyncedLocalStorage } from "@/lib/hooks/use-synced-local-storage";
+import { useMemo } from "react";
+
+export type PartnerLinksViewMode = "cards" | "rows";
+
+export function usePartnerLinksDisplay({
+ linksCount,
+ showDetailedAnalytics,
+}: {
+ linksCount?: number;
+ showDetailedAnalytics?: boolean;
+} = {}) {
+ const [preferTitle, setPreferTitle] = useSyncedLocalStorage(
+ "partnerLinksDisplayPreferTitle",
+ false,
+ );
+
+ const [persistedViewMode, setViewMode] =
+ useSyncedLocalStorage<PartnerLinksViewMode | null>(
+ "partnerLinksViewMode",
+ null,
+ );
+
+ const viewMode = useMemo<PartnerLinksViewMode>(() => {
+ if (persistedViewMode === "cards" || persistedViewMode === "rows") {
+ return persistedViewMode;
+ }
+
+ if ((linksCount && linksCount > 5) || !showDetailedAnalytics) return "rows";
+ return "cards";
+ }, [persistedViewMode, linksCount, showDetailedAnalytics]);
+
+ return {
+ preferTitle,
+ setPreferTitle,
+ viewMode,
+ setViewMode,
+ };
+}
diff --git a/apps/web/lib/zod/schemas/analytics-response.ts b/apps/web/lib/zod/schemas/analytics-response.ts
index 2305bafbf9..758b3b7f06 100644
--- a/apps/web/lib/zod/schemas/analytics-response.ts
+++ b/apps/web/lib/zod/schemas/analytics-response.ts
@@ -262,6 +262,10 @@ export const analyticsResponse = {
.string()
.nullish()
.describe("The custom link preview title (og:title)"),
+ partnerLinkTitle: z
+ .string()
+ .nullish()
+ .describe("The partner's private display title for the short link"),
comments: z.string().nullish().describe("The comments of the short link"),
folderId: z
.string()
diff --git a/apps/web/lib/zod/schemas/customer-activity.ts b/apps/web/lib/zod/schemas/customer-activity.ts
index 032833b1e9..a792625102 100644
--- a/apps/web/lib/zod/schemas/customer-activity.ts
+++ b/apps/web/lib/zod/schemas/customer-activity.ts
@@ -8,5 +8,6 @@ export const customerActivityResponseSchema = z.object({
domain: true,
key: true,
shortLink: true,
+ partnerLinkTitle: true,
}).nullish(),
});
diff --git a/apps/web/lib/zod/schemas/links.ts b/apps/web/lib/zod/schemas/links.ts
index d9e60df919..417b3b29c1 100644
--- a/apps/web/lib/zod/schemas/links.ts
+++ b/apps/web/lib/zod/schemas/links.ts
@@ -393,6 +393,14 @@ export const createLinkBodySchema = z.object({
.nullish()
.describe("The unique ID existing folder to assign the short link to."),
comments: z.string().nullish().describe("The comments for the short link."),
+ partnerLinkTitle: z
+ .string()
+ .nullish()
+ .describe("The partner's private display title for the short link."),
+ partnerLinkComments: z
+ .string()
+ .nullish()
+ .describe("The partner's private comments for the short link."),
expiresAt: z
.string()
.nullish()
@@ -707,6 +715,16 @@ export const LinkSchema = z
.string()
.nullable()
.describe("The comments for the short link."),
+ partnerLinkTitle: z
+ .string()
+ .nullish()
+ .default(null)
+ .describe("The partner's private display title for the short link."),
+ partnerLinkComments: z
+ .string()
+ .nullish()
+ .default(null)
+ .describe("The partner's private comments for the short link."),
shortLink: z
.url()
.describe(
diff --git a/apps/web/lib/zod/schemas/partner-profile.ts b/apps/web/lib/zod/schemas/partner-profile.ts
index baa1d344f7..e8e97b5518 100644
--- a/apps/web/lib/zod/schemas/partner-profile.ts
+++ b/apps/web/lib/zod/schemas/partner-profile.ts
@@ -44,6 +44,7 @@ export const PartnerEarningsSchema = CommissionSchema.omit({
id: true,
shortLink: true,
url: true,
+ partnerLinkTitle: true,
}).nullish(),
});
@@ -92,7 +93,8 @@ export const PartnerProfileLinkSchema = LinkSchema.pick({
leads: true,
sales: true,
saleAmount: true,
- comments: true,
+ partnerLinkTitle: true,
+ partnerLinkComments: true,
}).extend({
createdAt: z.string().or(z.date()),
partnerGroupDefaultLinkId: z.string().nullish(),
diff --git a/apps/web/lib/zod/schemas/partners.ts b/apps/web/lib/zod/schemas/partners.ts
index b7ffc40429..f3ed67d33d 100644
--- a/apps/web/lib/zod/schemas/partners.ts
+++ b/apps/web/lib/zod/schemas/partners.ts
@@ -815,6 +815,14 @@ export const createPartnerLinkSchema = partnerIdTenantIdSchema
"The short link slug. If not provided, a random 7-character slug will be generated.",
),
comments: z.string().nullish().describe("The comments for the short link."),
+ partnerLinkTitle: z
+ .string()
+ .nullish()
+ .describe("The partner's private display title for the short link."),
+ partnerLinkComments: z
+ .string()
+ .nullish()
+ .describe("The partner's private comments for the short link."),
})
.extend(
createPartnerSchema.pick({
diff --git a/apps/web/prisma/schema/link.prisma b/apps/web/prisma/schema/link.prisma
index 881a004bf4..91ab43f7bc 100644
--- a/apps/web/prisma/schema/link.prisma
+++ b/apps/web/prisma/schema/link.prisma
@@ -78,6 +78,10 @@ model Link {
// Comments on the particular shortlink
comments String? @db.Text
+ // Partner-owned display label and notes
+ partnerLinkTitle String?
+ partnerLinkComments String? @db.Text
+
dashboard Dashboard?
programId String?
diff --git a/apps/web/ui/analytics/events/events-table.tsx b/apps/web/ui/analytics/events/events-table.tsx
index 32ffa96fb4..4deda47371 100644
--- a/apps/web/ui/analytics/events/events-table.tsx
+++ b/apps/web/ui/analytics/events/events-table.tsx
@@ -1,6 +1,7 @@
"use client";
import { editQueryString } from "@/lib/analytics/utils";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import useWorkspace from "@/lib/swr/use-workspace";
import { useWorkspacePreferences } from "@/lib/swr/use-workspace-preferences";
import { ClickEvent, LeadEvent, SaleEvent } from "@/lib/types";
@@ -167,9 +168,22 @@ export default function EventsTable({
);
const [persisted] = useWorkspacePreferences("linksDisplay");
+ const { preferTitle: preferPartnerTitle } = usePartnerLinksDisplay();
const shortLinkTitle = useCallback(
- (d: { url?: string; title?: string; shortLink?: string }) => {
+ (d: {
+ url?: string;
+ title?: string;
+ partnerLinkTitle?: string | null;
+ shortLink?: string;
+ }) => {
+ if (partnerPage) {
+ if (preferPartnerTitle && d.partnerLinkTitle) {
+ return d.partnerLinkTitle;
+ }
+ return d.shortLink || "Unknown";
+ }
+
const displayProperties = persisted?.displayProperties;
if (displayProperties?.includes("title") && d.title) {
@@ -178,7 +192,7 @@ export default function EventsTable({
return d.shortLink || "Unknown";
},
- [persisted],
+ [persisted, partnerPage, preferPartnerTitle],
);
const sortBy = searchParams.get("sortBy") || "timestamp";
@@ -697,7 +711,7 @@ export default function EventsTable({
minSize: col.minSize || 100,
maxSize: col.maxSize || 1000,
})),
- [tab, product, partnerPage],
+ [tab, product, partnerPage, shortLinkTitle],
);
const { pagination, setPagination } = usePagination();
diff --git a/apps/web/ui/analytics/top-links.tsx b/apps/web/ui/analytics/top-links.tsx
index b81a76df91..4fb927c525 100644
--- a/apps/web/ui/analytics/top-links.tsx
+++ b/apps/web/ui/analytics/top-links.tsx
@@ -1,4 +1,5 @@
import { AnalyticsGroupByOptions } from "@/lib/analytics/types";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import { useWorkspacePreferences } from "@/lib/swr/use-workspace-preferences";
import { LinkLogo, useRouterStuff } from "@dub/ui";
import { Globe, Hyperlink } from "@dub/ui/icons";
@@ -133,6 +134,7 @@ export function TopLinks() {
});
const [persisted] = useWorkspacePreferences("linksDisplay");
+ const { preferTitle: preferPartnerTitle } = usePartnerLinksDisplay();
const getItemTitle = useCallback(
(d: Record<string, any>) => {
@@ -148,6 +150,13 @@ export function TopLinks() {
return d.tag?.name || "Unknown";
}
+ if (partnerPage) {
+ if (preferPartnerTitle && d.partnerLinkTitle) {
+ return d.partnerLinkTitle;
+ }
+ return d.shortLink || "Unknown";
+ }
+
// For links subtab
const displayProperties = persisted?.displayProperties;
@@ -157,7 +166,7 @@ export function TopLinks() {
return d.shortLink || "Unknown";
},
- [persisted, tab, subtab],
+ [persisted, tab, subtab, partnerPage, preferPartnerTitle],
);
const mapItem = useCallback(
diff --git a/apps/web/ui/analytics/use-analytics-filters.tsx b/apps/web/ui/analytics/use-analytics-filters.tsx
index e9041b57be..6ea1bd0615 100644
--- a/apps/web/ui/analytics/use-analytics-filters.tsx
+++ b/apps/web/ui/analytics/use-analytics-filters.tsx
@@ -3,6 +3,7 @@ import { VALID_ANALYTICS_FILTERS } from "@/lib/analytics/constants";
import useCustomer from "@/lib/swr/use-customer";
import usePartner from "@/lib/swr/use-partner";
import usePartnerCustomer from "@/lib/swr/use-partner-customer";
+import { usePartnerLinksDisplay } from "@/lib/swr/use-partner-links-display";
import { usePartnerTags } from "@/lib/swr/use-partner-tags";
import { CustomerAvatar } from "@/ui/customers/customer-avatar";
import { PartnerAvatar } from "@/ui/partners/partner-avatar";
@@ -422,6 +423,8 @@ export function useAnalyticsFilters({
const [streaming, setStreaming] = useState<boolean>(false);
+ const { preferTitle: preferPartnerTitle } = usePartnerLinksDisplay();
+
const LinkFilterItem = {
key: "linkId",
icon: Hyperlink,
@@ -432,11 +435,14 @@ export function useAnalyticsFilters({
return <LinkIcon url={url} />;
},
options:
- links?.map(({ id, domain, key, url, ...rest }) => ({
+ links?.map(({ id, domain, key, url, partnerLinkTitle, ...rest }) => ({
value: id,
- label: linkConstructor({ domain, key, pretty: true }),
+ label:
+ partnerPage && preferPartnerTitle && partnerLinkTitle
+ ? partnerLinkTitle
+ : linkConstructor({ domain, key, pretty: true }),
right: getFilterOptionTotal(rest),
- data: { url, domain, key },
+ data: { url, domain, key, partnerLinkTitle },
})) ?? null,
};
diff --git a/apps/web/ui/modals/partner-link-modal.tsx b/apps/web/ui/modals/partner-link-modal.tsx
index ce228bc3ef..71a315da07 100644
--- a/apps/web/ui/modals/partner-link-modal.tsx
+++ b/apps/web/ui/modals/partner-link-modal.tsx
@@ -53,7 +53,8 @@ import { usePartnerLinkQRModal } from "./partner-link-qr-modal";
interface PartnerLinkFormData {
key: string;
pathname: string;
- comments?: string;
+ partnerLinkTitle?: string;
+ partnerLinkComments?: string;
}
interface PartnerLinkModalProps {
@@ -218,7 +219,8 @@ function PartnerLinkModalContent({
? {
pathname: getPathnameFromUrl(link.url),
key: link.key,
- comments: link.comments ?? "",
+ partnerLinkTitle: link.partnerLinkTitle ?? "",
+ partnerLinkComments: link.partnerLinkComments ?? "",
}
: undefined,
});
@@ -470,16 +472,35 @@ function PartnerLinkModalContent({
<div>
<div className="flex items-center gap-2">
<label
- htmlFor="comments"
+ htmlFor="partnerLinkTitle"
+ className="block text-sm font-medium text-neutral-700"
+ >
+ Title
+ </label>
+ <InfoTooltip content="A private label to help you identify this link in your dashboard, analytics, and filters. Only you can see it." />
+ </div>
+ <input
+ {...register("partnerLinkTitle")}
+ type="text"
+ id="partnerLinkTitle"
+ className="mt-2 block w-full rounded-md border-neutral-300 text-neutral-900 placeholder-neutral-400 focus:border-neutral-500 focus:outline-none focus:ring-neutral-500 sm:text-sm"
+ placeholder="e.g. Instagram bio, YouTube description"
+ />
+ </div>
+
+ <div>
+ <div className="flex items-center gap-2">
+ <label
+ htmlFor="partnerLinkComments"
className="block text-sm font-medium text-neutral-700"
>
Comments
</label>
- <InfoTooltip content="Use comments to add context to your short links – for you and your team. [Learn more.](https://dub.co/help/article/link-comments)" />
+ <InfoTooltip content="Private notes for this link. Only you can see them." />
</div>
<TextareaAutosize
- {...register("comments")}
- id="comments"
+ {...register("partnerLinkComments")}
+ id="partnerLinkComments"
minRows={3}
className="mt-2 block w-full rounded-md border-neutral-300 text-neutral-900 placeholder-neutral-400 focus:border-neutral-500 focus:outline-none focus:ring-neutral-500 sm:text-sm"
placeholder="Add comments (optional)"