@financial-times/n-conversion-forms 28.9.0 → 29.0.0

package/components/accept-terms-subscription.jsx

@@ -0,0 +1,215 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+import classNames from 'classnames';
+
+export function AcceptTermsSubscription({
+	hasError = false,
+	isSignup = false,
+	isEmbedded = false,
+	isTrial = false,
+	isPrintProduct = false,
+	isSingleTerm = false,
+	isTransition = false,
+	transitionType = null,
+	isDeferredBilling = false,
+}) {
+	const divProps = {
+		id: 'acceptTermsField',
+		className: 'o-forms-field o-layout-typography ncf__validation-error',
+		'data-validate': 'required,checked',
+		...(isSignup && { 'data-trackable': 'sign-up-terms' }),
+	};
+	const labelClassName = classNames([
+		'o-forms-input',
+		'o-forms-input--checkbox',
+		{
+			'o-forms-input--invalid': hasError,
+		},
+	]);
+
+	const inputProps = {
+		id: 'termsAcceptance',
+		type: 'checkbox',
+		name: 'termsAcceptance',
+		value: 'true',
+		'data-trackable': 'field-terms',
+		'aria-required': 'true',
+		required: true,
+	};
+
+	const transitionTerms = isTransition && (
+		<>
+			{!isSingleTerm && (
+				<li>
+					<span className="terms-transition">
+						I give consent for my chosen payment method to be charged
+						automatically at the end of each subscription term until I cancel it
+						by contacting{' '}
+						<a
+							className="ncf__link--external"
+							href="https://help.ft.com/help/contact-us/"
+							target="_blank"
+							rel="noopener noreferrer"
+						>
+							customer care through chat, phone or email
+						</a>
+						.
+					</span>
+				</li>
+			)}
+			{transitionType === 'immediate' ? (
+				<li>
+					<span className="terms-transition terms-transition--immediate">
+						By placing my order, my subscription will start immediately and I am
+						aware and agree that I will therefore lose my statutory right to
+						cancel my subscription within 14 days of acceptance of my order. Any
+						notice of cancellation that I provide will only take effect at the
+						end of my subscription period and previously paid amounts are
+						non-refundable, except in the event that there is a fault in the
+						provision of the services.
+					</span>
+				</li>
+			) : (
+				<li>
+					<span className="terms-transition terms-transition--other">
+						By placing my order, I acknowledge that my subscription will start
+						{isSingleTerm
+							? ' and the chosen payment method will be charged '
+							: ' '}
+						on the date given above. Any cancellation notice received after that
+						date will take effect at the end of my subscription term and
+						previously paid amounts are non-refundable.
+					</span>
+				</li>
+			)}
+			<li>
+				<span className="terms-transition">
+					Find out more about our cancellation policy in our{' '}
+					<a
+						className="ncf__link--external"
+						href="http://help.ft.com/help/legal-privacy/terms-conditions/"
+						target="_blank"
+						rel="noopener noreferrer"
+					>
+						Terms &amp; Conditions
+					</a>
+					.
+				</span>
+			</li>
+		</>
+	);
+
+	const deferredBillingTerms = isDeferredBilling && (
+		<li>
+			<span className="terms-deferred">
+				Please note if you fail to make payment for your deferred billing plan
+				within due date your subscription will be automatically cancelled.
+			</span>
+		</li>
+	);
+
+	const printSignupTermText = isTrial
+		? 'Credits for delivery suspension or delivery failure are not available during introductory offer periods.'
+		: 'Credit for delivery suspensions is only available for hand-delivered subscriptions and is limited to a maximum of 24 issues per yearly subscription terms (4 issues per yearly FT Weekend subscription term).';
+
+	const printTerms = (
+		<>
+			<li>
+				<span className="terms-print">{printSignupTermText}</span>
+			</li>
+			<li>
+				<span className="terms-print">
+					Find out more about your delivery start date in our{' '}
+					<a
+						className="ncf__link--external"
+						href="http://help.ft.com/help/legal-privacy/terms-conditions/"
+						target={isEmbedded ? '_top' : '_blank'}
+						rel="noopener noreferrer"
+					>
+						Terms &amp; Conditions
+					</a>
+					.
+				</span>
+			</li>
+		</>
+	);
+
+	const nonPrintTerms = (
+		<>
+			<li>
+				<span className="terms-signup">
+					I give consent for my chosen payment method to be charged
+					automatically at the end of each subscription term until I cancel it
+					by contacting{' '}
+					<a
+						className="ncf__link--external"
+						href="https://help.ft.com/help/contact-us/"
+						target={isEmbedded ? '_top' : '_blank'}
+						rel="noopener noreferrer"
+					>
+						customer care through chat, phone or email
+					</a>
+					.
+				</span>
+			</li>
+			<li>
+				<span className="terms-signup">
+					By placing my order, my subscription will start immediately and I am
+					aware and agree that I will therefore lose my statutory right to
+					cancel my subscription within 14 days of acceptance of my order. Any
+					notice of cancellation that I provide will only take effect at the end
+					of my subscription period and previously paid amounts are
+					non-refundable, except in the event that there is a fault in the
+					provision of the services.
+				</span>
+			</li>
+			<li>
+				<span className="terms-signup">
+					Find out more about our cancellation policy in our{' '}
+					<a
+						className="ncf__link--external"
+						href="https://help.ft.com/legal-privacy/terms-and-conditions/"
+						target={isEmbedded ? '_top' : '_blank'}
+						rel="noopener noreferrer"
+					>
+						Terms &amp; Conditions
+					</a>
+					.
+				</span>
+			</li>
+		</>
+	);
+
+	const signupTerms = <>{isPrintProduct ? printTerms : nonPrintTerms}</>;
+
+	return (
+		<div {...divProps}>
+			<ul className="o-typography-list ncf__accept-terms-list">
+				{transitionTerms}
+				{signupTerms}
+				{deferredBillingTerms}
+			</ul>
+			<label className={labelClassName} htmlFor="termsAcceptance">
+				<input {...inputProps} />
+				<span className="o-forms-input__label">
+					I agree to the above terms &amp; conditions.
+				</span>
+				<p className="o-forms-input__error">
+					Please accept our terms &amp; conditions
+				</p>
+			</label>
+		</div>
+	);
+}
+
+AcceptTermsSubscription.propTypes = {
+	hasError: PropTypes.bool,
+	isSignup: PropTypes.bool,
+	isEmbedded: PropTypes.bool,
+	isTrial: PropTypes.bool,
+	isPrintProduct: PropTypes.bool,
+	isSingleTerm: PropTypes.bool,
+	isTransition: PropTypes.bool,
+	transitionType: PropTypes.string,
+	isDeferredBilling: PropTypes.bool,
+};

package/components/accept-terms-subscription.spec.js

@@ -0,0 +1,94 @@
+import React from 'react';
+import { mount } from 'enzyme';
+import { AcceptTermsSubscription } from './index';
+
+describe('AcceptTermsSubscription', () => {
+	it('renders with "o-forms-input--invalid" class when hasError prop is true', () => {
+		const props = { hasError: true };
+
+		const component = mount(<AcceptTermsSubscription {...props} />);
+
+		const labelElement = component.find('label');
+		expect(labelElement.hasClass('o-forms-input--invalid')).toBe(true);
+	});
+
+	it('renders without data-trackable attribute when isSignup prop is false', () => {
+		const props = {
+			isSignup: false,
+		};
+
+		const component = mount(<AcceptTermsSubscription {...props} />);
+
+		const labelElement = component.find(
+			'label[data-trackable="sign-up-terms"]'
+		);
+		expect(labelElement.exists()).toBe(false);
+	});
+
+	it('renders the external link with target="_top" when isEmbedded prop is true', () => {
+		const props = {
+			isEmbedded: true,
+		};
+
+		const component = mount(<AcceptTermsSubscription {...props} />);
+
+		const externalLink = component.find('.ncf__link--external').first();
+		expect(externalLink.prop('target')).toBe('_top');
+	});
+
+	it('does not render the trial-specific terms when isTrial prop is false', () => {
+		const props = {
+			isTrial: false,
+		};
+
+		const component = mount(<AcceptTermsSubscription {...props} />);
+
+		const trialTerms = component.find('.terms-print');
+		expect(trialTerms.exists()).toBe(false);
+	});
+
+	it('renders the print-specific terms when isPrintProduct prop is true', () => {
+		const props = {
+			isPrintProduct: true,
+		};
+
+		const component = mount(<AcceptTermsSubscription {...props} />);
+
+		const printTerms = component.find('.terms-print');
+		expect(printTerms.exists()).toBe(true);
+	});
+
+	it('renders the transition terms when isSingleTerm prop is true and isTransition prop is true', () => {
+		const props = {
+			isSingleTerm: true,
+			isTransition: true,
+		};
+
+		const component = mount(<AcceptTermsSubscription {...props} />);
+
+		const transitionTerms = component.find('.terms-transition');
+		expect(transitionTerms.exists()).toBe(true);
+	});
+
+	it('does not render the transition terms when transitionType prop is null', () => {
+		const props = {
+			transitionType: null,
+		};
+
+		const component = mount(<AcceptTermsSubscription {...props} />);
+
+		const transitionTerms = component.find('.terms-transition');
+		expect(transitionTerms.exists()).toBe(false);
+	});
+
+	it('renders the deferred billing terms when isDeferredBilling prop is true', () => {
+		const props = {
+			isDeferredBilling: true,
+		};
+
+		const component = mount(<AcceptTermsSubscription {...props} />);
+
+		const deferredBillingTerms = component.find('.terms-deferred');
+		expect(deferredBillingTerms.exists()).toBe(true);
+	});
+});

package/components/accept-terms-subscription.stories.js

@@ -0,0 +1,51 @@
+import React from 'react';
+import { AcceptTermsSubscription } from './accept-terms-subscription';
+
+export default {
+	title: 'Accept Terms Subscription',
+	component: AcceptTermsSubscription,
+};
+
+export const Basic = (args) => <AcceptTermsSubscription {...args} />;
+Basic.args = {};
+
+export const PrintProduct = (args) => <AcceptTermsSubscription {...args} />;
+
+PrintProduct.args = {
+	isPrintProduct: true,
+};
+
+export const PrintProductTrial = (args) => (
+	<AcceptTermsSubscription {...args} />
+);
+
+PrintProductTrial.args = {
+	isPrintProduct: true,
+	isTrial: true,
+};
+
+export const isSingleTerm = (args) => <AcceptTermsSubscription {...args} />;
+
+isSingleTerm.args = {
+	isSingleTerm: true,
+};
+
+export const isTransition = (args) => <AcceptTermsSubscription {...args} />;
+
+isTransition.args = {
+	isTransition: true,
+};
+
+export const transitionType = (args) => <AcceptTermsSubscription {...args} />;
+
+transitionType.args = {
+	transitionType: true,
+};
+
+export const isDeferredBilling = (args) => (
+	<AcceptTermsSubscription {...args} />
+);
+
+isDeferredBilling.args = {
+	isDeferredBilling: true,
+};

package/components/accept-terms.jsx

@@ -6,11 +6,9 @@ const DEFAULT_AGE_RESTRICTION = '16';
 const DEFAULT_PRIVACY_POLICIES_POSITION = 'top';
 
 export function AcceptTerms({
-	isAuthFirstAccount = false,
-	isAuthFirstPayment = false,
+	withPrivacyPolicyTerms = false,
 	hasError = false,
 	isSignup = false,
-	isRegister = false,
 	isChecked = false,
 	isB2b = false,
 	isB2cPartnership = false,
@@ -21,7 +19,6 @@ export function AcceptTerms({
 	isTransition = false,
 	transitionType = null,
 	isPrintProduct = false,
-	specialTerms = null,
 	isSingleTerm = false,
 	isDeferredBilling = false,
 	hideConfirmTermsAndConditions = false,
@@ -33,7 +30,6 @@ export function AcceptTerms({
 		className: 'o-forms-field o-layout-typography ncf__validation-error',
 		'data-validate': 'required,checked',
 		...(isSignup && { 'data-trackable': 'sign-up-terms' }),
-		...(isRegister && { 'data-trackable': 'register-up-terms' }),
 	};
 
 	const labelClassName = classNames([
@@ -55,8 +51,8 @@ export function AcceptTerms({
 		...(isChecked && { defaultChecked: true }),
 	};
 
-	const authFirstStepTerms = (
-		<div className="auth-first-step-terms">
+	const privacyPolicyTerms = (
+		<div className="privacy-policy-terms">
 			<span className={`consent-text--${privacyPoliciesPosition}`}>
 				For more information about how we use your data, please refer to our{' '}
 				<a
@@ -106,29 +102,6 @@ export function AcceptTerms({
 		</div>
 	);
 
-	const registerTerms = (
-		<label className={labelClassName} htmlFor="termsAcceptance">
-			<input {...inputProps} />
-			<span className="o-forms-input__label terms-register">
-				I confirm I am {ageRestriction} years or older and have read and agree
-				to the{' '}
-				<a
-					className="ncf__link--external"
-					href="http://help.ft.com/help/legal-privacy/terms-conditions/"
-					target={isEmbedded ? '_top' : '_blank'}
-					rel="noopener noreferrer"
-					data-trackable="terms-and-conditions"
-				>
-					Terms &amp; Conditions
-				</a>
-				.
-			</span>
-			<p className="o-forms-input__error">
-				Please accept our terms &amp; conditions
-			</p>
-		</label>
-	);
-
 	const b2bTerms = isB2b ? (
 		<li>
 			<span className="terms-b2b">
@@ -324,12 +297,6 @@ export function AcceptTerms({
 					</li>
 				</>
 			)}
-
-			{specialTerms && (
-				<li>
-					<span className="terms-special">{specialTerms}</span>
-				</li>
-			)}
 		</>
 	);
 
@@ -369,14 +336,12 @@ export function AcceptTerms({
 		<div {...divProps}>
 			{isB2cPartnership ? (
 				b2cPartnershipTerms
-			) : isRegister ? (
-				registerTerms
-			) : isAuthFirstAccount ? (
-				authFirstStepTerms
+			) : withPrivacyPolicyTerms ? (
+				privacyPolicyTerms
 			) : (
 				<>
 					<ul className="o-typography-list ncf__accept-terms-list">
-						{!isAuthFirstPayment && b2bTerms}
+						{b2bTerms}
 						{corpSignupTerms}
 						{transitionTerms}
 						{signupTerms}
@@ -398,9 +363,9 @@ export function AcceptTerms({
 }
 
 AcceptTerms.propTypes = {
+	withPrivacyPolicyTerms: PropTypes.bool,
 	hasError: PropTypes.bool,
 	isSignup: PropTypes.bool,
-	isRegister: PropTypes.bool,
 	isChecked: PropTypes.bool,
 	isB2b: PropTypes.bool,
 	isB2cPartnership: PropTypes.bool,
@@ -411,7 +376,6 @@ AcceptTerms.propTypes = {
 	isTransition: PropTypes.bool,
 	transitionType: PropTypes.string,
 	isPrintProduct: PropTypes.bool,
-	specialTerms: PropTypes.string,
 	isSingleTerm: PropTypes.bool,
 	isDeferredBilling: PropTypes.bool,
 	hideConfirmTermsAndConditions: PropTypes.bool,

package/components/accept-terms.spec.js

@@ -16,14 +16,8 @@ describe('AcceptTerms', () => {
 		expect(AcceptTerms).toRenderCorrectly(props);
 	});
 
-	it('renders appropriately if a isAuthFirstAccount', () => {
-		const props = { isAuthFirstAccount: true };
-
-		expect(AcceptTerms).toRenderCorrectly(props);
-	});
-
-	it('renders appropriately if a isAuthFirstPayment', () => {
-		const props = { isAuthFirstPayment: true };
+	it('renders a component matching snapshot when withPrivacyPolicyTerms is true', () => {
+		const props = { withPrivacyPolicyTerms: true };
 
 		expect(AcceptTerms).toRenderCorrectly(props);
 	});
@@ -70,21 +64,6 @@ describe('AcceptTerms', () => {
 		expect(AcceptTerms).toRenderCorrectly(props);
 	});
 
-	it('renders appropriately if a signup and has special terms', () => {
-		const props = {
-			isSignup: true,
-			specialTerms: 'Special terms text',
-		};
-
-		expect(AcceptTerms).toRenderCorrectly(props);
-	});
-
-	it('renders appropriately if a registration', () => {
-		const props = { isRegister: true };
-
-		expect(AcceptTerms).toRenderCorrectly(props);
-	});
-
 	it('renders appropriately if input is checked', () => {
 		const props = { isChecked: true };
 

package/components/accept-terms.stories.js

@@ -12,16 +12,14 @@ export default {
 				options: ['immediate', 'endOfTerm'],
 			},
 		},
-		isAuthFirstAccount: {
+		withPrivacyPolicyTerms: {
 			control: 'boolean',
 			table: {
-				type: { summary: 'Show new buy flow design' },
+				type: { summary: 'Show privacy policy terms' },
 			},
 		},
-		isAuthFirstPayment: { control: 'boolean' },
 		hasError: { control: 'boolean' },
 		isSignup: { control: 'boolean' },
-		isRegister: { control: 'boolean' },
 		isChecked: { control: 'boolean' },
 		isB2b: { control: 'boolean' },
 		isB2cPartnership: { control: 'boolean' },
@@ -36,7 +34,9 @@ export default {
 		children: {
 			control: false,
 			table: {
-				type: { summary: "Only rendered when 'isAuthFirstAccount' is true" },
+				type: {
+					summary: "Only rendered when 'withPrivacyPolicyTerms' is true",
+				},
 			},
 		},
 		privacyPoliciesPosition: {
@@ -56,12 +56,12 @@ Basic.args = {};
 
 export const NewBuyFlow = (args) => <AcceptTerms {...args} />;
 NewBuyFlow.args = {
-	isAuthFirstAccount: true,
+	withPrivacyPolicyTerms: true,
 };
 
 export const NewBuyFlowEmailVerification = (args) => <AcceptTerms {...args} />;
 NewBuyFlowEmailVerification.args = {
-	isAuthFirstAccount: true,
+	withPrivacyPolicyTerms: true,
 	hideConfirmTermsAndConditions: true,
 };
 
@@ -71,12 +71,12 @@ export const NewBuyFlowWithChildren = (args) => (
 	</AcceptTerms>
 );
 NewBuyFlowWithChildren.args = {
-	isAuthFirstAccount: true,
+	withPrivacyPolicyTerms: true,
 	privacyPoliciesPosition: 'bottom',
 };
 NewBuyFlowWithChildren.parameters = {
 	controls: {
-		include: ['privacyPoliciesPosition', 'isAuthFirstAccount', 'children'],
+		include: ['privacyPoliciesPosition', 'withPrivacyPolicyTerms', 'children'],
 		expanded: true,
 	},
 };

package/components/index.jsx

@@ -1,4 +1,7 @@
 export { AcceptTerms } from './accept-terms';
+export { AcceptTermsPrivacyPolicy } from './accept-terms-privacy-policy';
+export { AcceptTermsSubscription } from './accept-terms-subscription';
+export { AcceptTermsBusiness } from './accept-terms-business';
 export { AppBanner } from './app-banner';
 export { BillingCity } from './billing-city';
 export { BillingCountry } from './billing-country';

package/dist/accept-terms-business.js

@@ -0,0 +1,74 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AcceptTermsBusiness = AcceptTermsBusiness;
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+function AcceptTermsBusiness(_ref) {
+  var _ref$hasError = _ref.hasError,
+    hasError = _ref$hasError === void 0 ? false : _ref$hasError,
+    _ref$isB2b = _ref.isB2b,
+    isB2b = _ref$isB2b === void 0 ? false : _ref$isB2b,
+    _ref$isEmbedded = _ref.isEmbedded,
+    isEmbedded = _ref$isEmbedded === void 0 ? false : _ref$isEmbedded,
+    _ref$isTrial = _ref.isTrial,
+    isTrial = _ref$isTrial === void 0 ? false : _ref$isTrial;
+  var divProps = {
+    id: 'acceptTermsField',
+    className: 'o-forms-field o-layout-typography ncf__validation-error',
+    'data-validate': 'required,checked'
+  };
+  var labelClassName = (0, _classnames["default"])(['o-forms-input', 'o-forms-input--checkbox', {
+    'o-forms-input--invalid': hasError
+  }]);
+  var inputProps = {
+    id: 'termsAcceptance',
+    type: 'checkbox',
+    name: 'termsAcceptance',
+    value: 'true',
+    'data-trackable': 'field-terms',
+    'aria-required': 'true',
+    required: true
+  };
+  var b2bTerms = isB2b ? /*#__PURE__*/_react["default"].createElement("li", null, /*#__PURE__*/_react["default"].createElement("span", {
+    className: "terms-b2b"
+  }, "By submitting this form, you indicate your consent to also being contacted by Financial Times by email, post, or phone about our other products, services or special offers unless you untick this box.")) : /*#__PURE__*/_react["default"].createElement("li", null, /*#__PURE__*/_react["default"].createElement("span", {
+    className: "terms-default"
+  }, "I confirm I am 16 years or older and have read and agree to the", ' ', /*#__PURE__*/_react["default"].createElement("a", {
+    className: "ncf__link--external",
+    href: "http://help.ft.com/help/legal-privacy/terms-conditions/",
+    target: isEmbedded ? '_top' : '_blank',
+    rel: "noopener noreferrer",
+    "data-trackable": "terms-and-conditions"
+  }, "Terms & Conditions"), "."));
+  var corpSignupTerms = /*#__PURE__*/_react["default"].createElement(_react["default"].Fragment, null, /*#__PURE__*/_react["default"].createElement("li", null, /*#__PURE__*/_react["default"].createElement("span", {
+    className: "terms-corp-signup"
+  }, "Your organisation\u2019s administrator(s) may view basic usage and profile data about your account and have the ability to set up myFT topic follows on your behalf.")), /*#__PURE__*/_react["default"].createElement("li", null, /*#__PURE__*/_react["default"].createElement("span", {
+    className: "terms-corp-signup"
+  }, "Basic usage and profile data about your account can include; for example, your job title and profile information, the date you last visited, volume of content consumed, etc.")), /*#__PURE__*/_react["default"].createElement("li", null, /*#__PURE__*/_react["default"].createElement("span", {
+    className: "terms-corp-signup"
+  }, "myFT topics may be selected on your behalf by your company administrator or FT representative for you to follow. You can unfollow these topics or unsubscribe from the myFT digest through the Contact preferences section on myFT.")), isTrial && /*#__PURE__*/_react["default"].createElement("li", null, /*#__PURE__*/_react["default"].createElement("span", {
+    className: "terms-corp-signup"
+  }, "This trial is to demonstrate the value of a group subscription and we\u2019ll contact you during your trial.")));
+  return /*#__PURE__*/_react["default"].createElement("div", divProps, /*#__PURE__*/_react["default"].createElement("ul", {
+    className: "o-typography-list ncf__accept-terms-list"
+  }, b2bTerms, corpSignupTerms), /*#__PURE__*/_react["default"].createElement("label", {
+    className: labelClassName,
+    htmlFor: "termsAcceptance"
+  }, /*#__PURE__*/_react["default"].createElement("input", inputProps), /*#__PURE__*/_react["default"].createElement("span", {
+    className: "o-forms-input__label"
+  }, "I agree to the above terms & conditions."), /*#__PURE__*/_react["default"].createElement("p", {
+    className: "o-forms-input__error"
+  }, "Please accept our terms & conditions")));
+}
+AcceptTermsBusiness.propTypes = {
+  hasError: _propTypes["default"].bool,
+  isChecked: _propTypes["default"].bool,
+  isB2b: _propTypes["default"].bool,
+  isEmbedded: _propTypes["default"].bool,
+  isTrial: _propTypes["default"].bool
+};