Epic: Campaigns

assets/src/css/admin/_components.admin-header.scss

@@ -5,6 +5,10 @@
 .post-type-give_forms,
 .give_forms_page_give-subscriptions {
 
+    .page-title-action:not(.switch-new-view) {
+        display: none;
+    }
+
 	.wp-header-end + .notice {
 		margin-top: 11px;
 	}

assets/src/js/admin/reports/components/no-data-notice/index.js

@@ -1,71 +1,82 @@
 // Dependencies
-import { useState, Fragment } from 'react';
-import { __ } from '@wordpress/i18n'
-import { getWindowData } from '../../utils';
+import {Fragment, useState} from 'react';
+import {__} from '@wordpress/i18n';
+import {getWindowData} from '../../utils';
 
 // Store-related dependencies
-import { useStoreValue } from '../../store';
-import { disablePeriodSelector } from '../../store/actions';
+import {useStoreValue} from '../../store';
+import {disablePeriodSelector} from '../../store/actions';
 
 // Styles
 import './style.scss';
 
-const NoDataNotice = ( { version } ) => {
-	const [ {}, dispatch ] = useStoreValue();
+const NoDataNotice = ({version}) => {
+    const [{}, dispatch] = useStoreValue();
 
-	const [ showNotice, setShowNotice ] = useState( true );
+    const [showNotice, setShowNotice] = useState(true);
 
-	const loadSampleData = () => {
-		setShowNotice( false );
-		dispatch( disablePeriodSelector() );
-	};
+    const loadSampleData = () => {
+        setShowNotice(false);
+        dispatch(disablePeriodSelector());
+    };
 
-	const goToNewFormUrl = () => {
-		const url = getWindowData( 'newFormUrl' );
-		window.location = url;
-	};
+    const goToNewFormUrl = () => {
+        const url = getWindowData('newFormUrl');
+        window.location = url;
+    };
 
-	return (
-		<Fragment>
-			{ showNotice && (
-				<div className="givewp-not-found-notice">
-					<div className="givewp-not-found-card">
-						{ version === 'dashboard' ? (
-							<Fragment>
-								<h2>{ __( 'Get a quick view of your', 'give' ) }<br />{ __( 'donation activity', 'give' ) }</h2>
-								<p>
-									{ __( 'It looks like there hasn\'t been any donations yet on your website.', 'give' ) } <br />
-									{ __( 'Set up a donation form to begin collecting donations now.', 'give' ) } <br />
-								</p>
-								<button
-									onClick={ () => goToNewFormUrl() }
-									className="givewp-not-found-notice-button">
-									{ __( 'Create a Donation Form', 'give' ) }
-								</button>
-							</Fragment>
-						) : (
-							<Fragment>
-								<h2>{ __( 'Get a detailed view of your', 'give' ) }<br />{ __( 'donation activity', 'give' ) }</h2>
-								<p>
-									{ __( 'It looks like there hasn\'t been any donations yet on your website. ', 'give' ) } <br />
-									{ __( 'Set up a donation form to begin collection donations or load some sample data to preview what the reports look like.', 'give' ) } <br />
-								</p>
-								<button
-									onClick={ () => loadSampleData() }
-									className="givewp-not-found-notice-button">
-									{ __( 'Explore Sample Reports', 'give' ) }
-								</button>
-							</Fragment>
-						) }
-					</div>
-				</div>
-			) }
-		</Fragment>
-	);
+    return (
+        <Fragment>
+            {showNotice && (
+                <div className="givewp-not-found-notice">
+                    <div className="givewp-not-found-card">
+                        {version === 'dashboard' ? (
+                            <Fragment>
+                                <h2>
+                                    {__('Get a quick view of your', 'give')}
+                                    <br />
+                                    {__('donation activity', 'give')}
+                                </h2>
+                                <p>
+                                    {__("It looks like there hasn't been any donations yet on your website.", 'give')}{' '}
+                                    <br />
+                                    {__('Set up a campaign form to begin collecting donations now.', 'give')}
+                                    <br />
+                                </p>
+                                <button onClick={() => goToNewFormUrl()} className="givewp-not-found-notice-button">
+                                    {__('Create a Campaign Form', 'give')}
+                                </button>
+                            </Fragment>
+                        ) : (
+                            <Fragment>
+                                <h2>
+                                    {__('Get a detailed view of your', 'give')}
+                                    <br />
+                                    {__('donation activity', 'give')}
+                                </h2>
+                                <p>
+                                    {__("It looks like there hasn't been any donations yet on your website. ", 'give')}{' '}
+                                    <br />
+                                    {__(
+                                        'Set up a campaign form to begin collection donations or load some sample data to preview what the reports look like.',
+                                        'give'
+                                    )}{' '}
+                                    <br />
+                                </p>
+                                <button onClick={() => loadSampleData()} className="givewp-not-found-notice-button">
+                                    {__('Explore Sample Reports', 'give')}
+                                </button>
+                            </Fragment>
+                        )}
+                    </div>
+                </div>
+            )}
+        </Fragment>
+    );
 };
 
 NoDataNotice.defaultProps = {
-	version: 'app',
+    version: 'app',
 };
 
 export default NoDataNotice;

blocks/components/no-form/index.js

@@ -1,33 +1,38 @@
 /**
  * WordPress dependencies
  */
-import { __ } from '@wordpress/i18n'
-import { Button } from '@wordpress/components';
+import {__} from '@wordpress/i18n';
+import {Button} from '@wordpress/components';
 
 /**
  * Internal dependencies
  */
-import { getSiteUrl } from '../../utils';
+import {getSiteUrl} from '../../utils';
 import GiveBlankSlate from '../blank-slate';
 
 /**
  * Render No forms Found UI
-*/
+ *
+ * @unreleased Replace "new form" with "new campaign form" link
+ */
 
 const NoForms = () => {
-	return (
-		<GiveBlankSlate title={ __( 'No donation forms found.', 'give' ) }
-			description={ __( 'The first step towards accepting online donations is to create a form.', 'give' ) }
-			helpLink>
-			<Button
-				isPrimary
-				isLarge
-				className="give-blank-slate__cta"
-				href={ `${ getSiteUrl() }/wp-admin/post-new.php?post_type=give_forms` }>
-				{ __( 'Create Donation Form', 'give' ) }
-			</Button>
-		</GiveBlankSlate>
-	);
+    return (
+        <GiveBlankSlate
+            title={__('No campaign forms found.', 'give')}
+            description={__('The first step towards accepting online donations is to create a campaign.', 'give')}
+            helpLink
+        >
+            <Button
+                isPrimary
+                isLarge
+                className="give-blank-slate__cta"
+                href={`${getSiteUrl()}/wp-admin/edit.php?post_type=give_forms&page=give-campaigns&new=campaign`}
+            >
+                {__('Create Campaign Form', 'give')}
+            </Button>
+        </GiveBlankSlate>
+    );
 };
 
 export default NoForms;

blocks/donation-form-grid/class-give-donation-form-grid-block.php

@@ -270,6 +270,7 @@ private function getAsArray($value) {
 	/**
 	 * Return formatted notice when shortcode return empty string
 	 *
+     * @unreleased Replace "new form" with "new campaign form" link
 	 * @since 2.4.0
 	 *
 	 * @return string
@@ -284,10 +285,11 @@ private function blank_slate() {
 		$content = array(
 			'image_url' => GIVE_PLUGIN_URL . 'assets/dist/images/give-icon-full-circle.svg',
 			'image_alt' => __( 'Give Icon', 'give' ),
-			'heading'   => __( 'No donation forms found.', 'give' ),
-			'message'   => __( 'The first step towards accepting online donations is to create a form.', 'give' ),
-			'cta_text'  => __( 'Create Donation Form', 'give' ),
-			'cta_link'  => admin_url( 'post-new.php?post_type=give_forms' ),
+            'heading' => __('No campaign forms found.', 'give'),
+            'message' => __('The first step towards accepting online donations is to create a campaign.',
+                'give'),
+            'cta_text' => __('Create Campaign Form', 'give'),
+            'cta_link' => admin_url('edit.php?post_type=give_forms&page=give-campaigns&new=campaign'),
 			'help'      => sprintf(
 				/* translators: 1: Opening anchor tag. 2: Closing anchor tag. */
 				__( 'Need help? Get started with %1$sGive 101%2$s.', 'give' ),

composer.json

@@ -19,7 +19,8 @@
         "woocommerce/action-scheduler": "^3.6",
         "psr/container": "1.1.1",
         "ext-json": "*",
-        "stellarwp/admin-notices": "^2.0"
+        "stellarwp/admin-notices": "^2.0",
+        "stellarwp/arrays": "^1.3"
     },
     "require-dev": {
         "fakerphp/faker": "^1.9",
@@ -96,6 +97,7 @@
             "classmap_prefix": "Give_Vendors_",
             "constant_prefix": "GIVE_VENDORS_",
             "packages": [
+                "stellarwp/arrays",
                 "stellarwp/admin-notices",
                 "stellarwp/validation",
                 "stellarwp/field-conditions",

give.php

@@ -42,6 +42,7 @@
  * - The GiveWP Team
  */
 
+use Give\Campaigns\Repositories\CampaignRepository;
 use Give\Container\Container;
 use Give\DonationForms\ServiceProvider as DonationFormsServiceProvider;
 use Give\DonationForms\V2\Repositories\DonationFormsRepository;
@@ -133,6 +134,7 @@
  * @property-read DonorRepositoryProxy $donors
  * @property-read SubscriptionRepository $subscriptions
  * @property-read DonationFormsRepository $donationForms
+ * @property-read CampaignRepository $campaigns
  * @property-read Profile $donorDashboard
  * @property-read TabsRegister $donorDashboardTabs
  * @property-read Give_Recurring_DB_Subscription_Meta $subscription_meta
@@ -245,6 +247,7 @@ final class Give
         Give\FormTaxonomies\ServiceProvider::class,
         Give\DonationSpam\ServiceProvider::class,
         Give\Settings\ServiceProvider::class,
+        Give\Campaigns\ServiceProvider::class,
         Give\FeatureFlags\OptionBasedFormEditor\ServiceProvider::class,
         Give\ThirdPartySupport\ServiceProvider::class,
     ];

includes/admin/class-blank-slate.php

@@ -249,20 +249,23 @@ private function donor_exists() {
 	/**
 	 * Gets the content of a blank slate message based on provided context.
 	 *
-	 * @since 1.8.13
+     * @unreleased Replace "new form" with "new campaign form" link
+     * @since 1.8.13
 	 *
 	 * @param string $context The key used to determine which content is returned.
+	 *
 	 * @return array Blank slate content.
 	 */
 	private function get_content( $context ) {
 		// Define default content.
 		$defaults = array(
 			'image_url' => GIVE_PLUGIN_URL . 'assets/dist/images/give-icon-full-circle.svg',
-			'image_alt' => __( 'GiveWP Icon', 'give' ),
-			'heading'   => __( 'No donation forms found.', 'give' ),
-			'message'   => __( 'The first step towards accepting online donations is to create a form.', 'give' ),
-			'cta_text'  => __( 'Create Donation Form', 'give' ),
-			'cta_link'  => admin_url( 'post-new.php?post_type=give_forms' ),
+			'image_alt' => __( 'GiveWP Icon', 'give'),
+            'heading' => __('No campaign forms found.', 'give'),
+            'message' => __('The first step towards accepting online donations is to create a campaign.',
+                'give'),
+            'cta_text' => __('Create Campaign Form', 'give'),
+            'cta_link' => admin_url('edit.php?post_type=give_forms&page=give-campaigns&new=campaign'),
 			'help'      => sprintf(
 				/* translators: 1: Opening anchor tag. 2: Closing anchor tag. */
 				__( 'Need help? Get started with %1$sGive 101%2$s.', 'give' ),

includes/admin/shortcodes/shortcode-give-form.php

@@ -33,14 +33,16 @@ public function __construct() {
 	/**
 	 * Define the shortcode attribute fields
 	 *
-	 * @return array
+     * @unreleased Replace "new form" with "new campaign form" link
+     *
+     * @return array
 	 */
 	public function define_fields() {
 
 		$create_form_link = sprintf(
 			/* translators: %s: create new form URL */
-			__( '<a href="%s">Create</a> a new Donation Form.', 'give' ),
-			admin_url( 'post-new.php?post_type=give_forms' )
+            __('<a href="%s">Create</a> a new Campaign Form.', 'give'),
+            admin_url('edit.php?post_type=give_forms&page=give-campaigns&new=campaign')
 		);
 
 		return array(
@@ -51,10 +53,11 @@ public function define_fields() {
 				),
 				'name'        => 'id',
 				'tooltip'     => esc_attr__( 'Select a Donation Form', 'give' ),
-				'placeholder' => '- ' . esc_attr__( 'Select a Donation Form', 'give' ) . ' -',
+                'placeholder' => '- ' . esc_attr__('Select a Campaign Form', 'give') . ' -',
 				'required'    => array(
-					'alert' => esc_html__( 'You must first select a Form!', 'give' ),
-					'error' => sprintf( '<p class="strong">%s</p><p class="no-margin">%s</p>', esc_html__( 'No forms found.', 'give' ), $create_form_link ),
+                    'alert' => esc_html__('You must first select a Campaign Form!', 'give'),
+                    'error' => sprintf('<p class="strong">%s</p><p class="no-margin">%s</p>',
+                        esc_html__('No campaign forms found.', 'give'), $create_form_link),
 				),
 			),
 			array(