Wiki source code of Products - How to Create a Product

Last modified by Admin User on 2025/03/11 18:15

version	line-number	content
4.1	1	{{layout}}
	2	{{layout-section ac:type="two_right_sidebar"}}
	3	{{layout-cell}}
3.1	4	{{id name="Start ScreenSteps Content"/}}
10.1	5	The directions below provide detail on how to create a new Product. Once a Product is created it can be attached to a Package.
3.1	6
12.1	7	Products may be created in the Products tool (as described in this lesson) prior to being attached to a Package, or they can be created during the Package creation process. Please refer to [[Packages - How to Create a Package Part 3: Attach / Remove / Create a Product >>doc:OD.Packages - How to Create a Package Part 3: Attach Remove Create a Product]]for details creating Products during the Package creation process and attaching to a Package.
3.1	8
10.1	9	Please refer to the [[Quick Start Guide - Products >>doc:Quick Start Guide - Packages and Products]]for information on basic concepts and rules relating to Packages, terms, and Products.
3.1	10
10.1	11	=== CREATE A NEW Product ===
3.1	12
10.1	13	There are four different types of Products: File, Newsletter, Page, and Section. Details on each type of Product are given below.
3.1	14
13.1	15	~1. Select SETUP from the main menu.
3.1	16
13.1	17	[[image:attach:Screen Shot 2021-09-23 at 4.20.31 PM (2).png\|\|thumbnail="true" height="250"]]
3.1	18
	19
13.1	20	2. Select Products form the SETUP sub-menu.
6.1	21
13.1	22	[[image:attach:Screen Shot 2021-10-08 at 3.22.01 PM (2).png\|\|thumbnail="true" height="250"]]
3.1	23
10.1	24	This will open the Products listing page, where all existing Products are listed in alphabetical order. Note the Search and page-through functionality.
3.1	25
	26
10.1	27	3. Click "Create New Product" found in upper right of the Product list. This will open the New Product window.
3.1	28
13.1	29	[[image:attach:Screen Shot 2021-10-08 at 3.40.35 PM (2).png\|\|height="250"]]
3.1	30
	31
	32
10.1	33	4. Enter a title and description for the Product.
6.1	34
16.1	35	[[image:attach:media_1433259152985.png\|\|style="vertical-align:middle"]]
3.1	36
10.1	37	The title should be as brief but descriptive as possible. For example if the Product is a newsletter, the title could be the name of the newsletter; or if the Product is access to a video series, then the title could be the name of the video series.
3.1	38
	39
10.1	40	5. Select the type of Product (File, Newsletter, Page, Section).
6.1	41
16.1	42	[[image:attach:media_1433259276492.png\|\|style="vertical-align:middle"]]
3.1	43
10.1	44	Further detail on the different types of Products is given below.
3.1	45
6.1	46	----
3.1	47
10.1	48	==== __Product Type: File__ ====
6.1	49
10.1	50	To restrict access to a file and/or identify it for a dashboard, such as a specific whitepaper or other document select Product Type: File.
3.1	51
10.1	52	When you select "File" from the "Product Type:" drop-down menu, you will see the message “Files in the [[root folder>>doc:root folder]] directory can be protected from unauthorized downloads”.
3.1	53
6.1	54	~1. Under "Choose File" select the file you wish to restrict access to.
3.1	55
16.1	56	[[image:attach:media_1366403738301.png\|\|style="vertical-align:middle"]]
3.1	57
	58	The directory tree of your root folder will be displayed, and you can select your file here.
	59
	60
10.1	61	2. Click "Save", and the file-type Product will be saved.
6.1	62
16.1	63	[[image:attach:media_1404935503453.png\|\|style="vertical-align:middle"]]
3.1	64
10.1	65	You will receive a confirmation message, as shown above, indicating the time the Product was saved.
	66	To return to the Products listing page, which will show your new Product in the alphabetical list, click on the Go Back button.
3.1	67
10.1	68	Note: You may cancel Product creation by clicking on the Go Back button before clicking Save. Doing so will bring you back to the Products listing page without creating a Product.
3.1	69
	70
6.1	71	----
	72
10.1	73	==== __Product Type: Function__ ====
6.1	74
3.1	75	Gating is currently done based on the a REGEX match of a url segment on page load. This function is designed to allow customers to gate content where gating can not be sufficiently managed using URL segments or where content must be gated without a page load.
	76
10.1	77	The Function-type Product works in conjunction with ONEcount's javascript widgets, and it expects one parameter which is the numeric Product id. The ProductId is required. Product Ids are available in ONEcount on the Product listing page.
3.1	78
	79	For more information on ONEcount javascript widgets and their functionality, see the ONEcount Javascript Widgets and ONEcount Javascript Widget Changes sections.
	80
	81
10.1	82	~1. Select "Product Type:" of Function and enter a text return value in the Value field.
6.1	83
16.1	84	[[image:attach:media_1479414072383.png\|\|style="vertical-align:middle"]]
3.1	85
	86	The text return value is currently ignored, but it may be used to trigger gating in the future.
	87
10.1	88	Save the Product
3.1	89
17.1	90	*
3.1	91	** Note that the users entering from the following referrers will be bypassed: Bing, Google, Facebook, Twitter, LinkedIn. i.e. if a user comes to an article from one of these referrers they'll be granted access. If they click on another article link, they'll then be required to register. This can be disabled, but doing so may prevent bots from indexing.
	92
17.1	93	*
	94	**
10.1	95	*** You can use the Function-type Product in conjunction with a free pass, i.e. any non-registered/logged in user can view x articles before having to register for the "Article Access" Package. After registering for the "Article Access" Package, if you've enabled the access frequency the user will be able to view x articles in n timeframe before being required to subscribe to a paid Package/package.
3.1	96
10.1	97	Save the Product.
3.1	98
	99
10.1	100	2. On the template of the page(s) you wish to gate/identify, add the following ONEcount function: GCN.onecount.gate(Productid)
3.1	101
10.1	102	For example, if the function-type Product ID is 25, the js function would be GCN.onecount.gate(25)
3.1	103
10.1	104	The Product id of the Function-type Product you created is required.
3.1	105
	106	You can place this anywhere on the template.
	107
6.1	108	----
3.1	109
10.1	110	==== __Product Type: Newsletters__ ====
6.1	111
16.1	112	[[image:attach:media_1433259708825.png\|\|style="vertical-align:middle"]]
3.1	113
10.1	114	To create a Newsletter-type Product and a newsletter list in the Email Engine, select Product Type: Newsletters.
3.1	115
10.1	116	When you select "Newsletters" from the "Product Type:" drop-down menu, you will see the message "Please Select Newsletters to associate with this Product" with a drop-down check box list of all existing newsletter lists (called subscriber lists the Email Engine). This list of Newsletters shows all of the existing newsletter/subscriber lists that reside in the EMail Engine.
3.1	117
16.1	118	(% style="color:#ff0000" %)*If using the Email Engine to manage your newsletter/email lists, when a newsletter Product is created, ONEcount will automatically create a newsletter list in the Email Engine. When users submit the subscription form for the Package with the newsletter Product, they will automatically be placed on the newsletter list in the Email Engin. Their demographic and subscription data will also be added the ONEcount database. If you are using a different email marketing provider (such as Magnet Mail or Silverpop), please check with GCN to verify if an API is available.
3.1	119
16.1	120	(% style="color:#ff0000" %)The Product must be created and attached to a Package prior to an import or user subscription via an online form. ONEcount won't push Package subscribers to a newsletter Product created (% style="color:#ff0000; text-decoration:underline" %)after(% style="color:#ff0000" %) the user subscribed to a Package (either through import or user action)(% style="color:#000000" %).
3.1	121
	122
6.1	123
10.1	124	1a. To associate the Newsletter Product with an existing Newsletter list that has been created in the Email Engine, check the box beside the newsletter list(s) you wish to associate with the Newsletter Product.
6.1	125
16.1	126	[[image:attach:media_1433259752525.png\|\|style="vertical-align:middle"]]
3.1	127
10.1	128	You can select the newsletter(s) you wish to associate with the Product - and by extension with the Package - or create a new Newsletter list (subscriber list).
3.1	129
10.1	130	When you create a new Newsletter-type Product you, in effect, create a new, empty list in the Email Engine that is associated with the Newsletter Product.
3.1	131
16.1	132	(% style="color:#000000" %)A newsletter Product may have more than one list associated with it. For example, you may have a newsletter Package/Product where a user can sign up to receive multiple newsletters (sent on different schedules, e.g. one weekly and one monthly) as part of a bundled package. In such an instance, you could attach more than one newsletter list to the Product, and when a person subscribes to the Package/Product, he/she will be placed on both newsletter lists.
3.1	133
	134
6.1	135
	136	1b. To create a new newsletter list in the Email Engine, click on +"Add New Newsletter" link.
	137
16.1	138	[[image:attach:media_1433259811030.png\|\|style="vertical-align:middle"]]
3.1	139
	140
6.1	141	2b. Enter the Newsletter List Name (1) and Description (2) then click "Add" (3).
	142
16.1	143	[[image:attach:media_1433259848182.png\|\|style="vertical-align:middle"]]
3.1	144
6.1	145
3.1	146	You will see the newly created newsletter list, with a check mark, at the top of the newsletter list, as shown below.
	147
16.1	148	[[image:attach:media_1433260091890.png\|\|style="vertical-align:middle"]]
3.1	149
10.1	150	Select any other newsletter lists (if any) you wish to associate with this Product, as shown below.
3.1	151
16.1	152	[[image:attach:media_1433260212319.png\|\|style="vertical-align:middle"]]
3.1	153
	154
6.1	155	3b. Click the "Save" button, and the newsletter list will be saved.
	156
16.1	157	[[image:attach:media_1404935553287.png\|\|style="vertical-align:middle"]]
3.1	158
10.1	159	You will receive a confirmation message, as shown above, indicating the time the Product was saved.
	160	To return to the Products listing page, which will show your new Product in the alphabetical list, click on the Go Back button.
3.1	161
10.1	162	Note: You may cancel Product creation by clicking on the Go Back button before clicking Save. Doing so will bring you back to the Products listing page without creating a Product.
3.1	163
	164
6.1	165	----
	166
14.1	167	==== __Product Type: URL__ ====
6.1	168
3.1	169
14.1	170	To restrict access to a web page on your site and/or identify it for a dashboard, select Product Type: URL.
3.1	171
14.1	172	When you select "URL" from the "Product Type:" the Edit Product screen will change to give you some additional options which we will discuss here.
3.1	173
14.1	174	First, give you product is a Title. This is what will appear on any gating or subscription forms on your site, and on all internal, ONEcount menus where this product is listed.
	175
	176	If you would like an image displayed on forms using this product, put a link to the image in the Image URL box. For example, if the product is for a web-site or print product, you can put a link to the cover-image of the product in this box.
	177
	178	Primary Form or Landing URL: This box is important. This tells ONEcount what form to present when a user clicks on the URLs covered by this product. If you are using a ONEcount form to register or subscribe users, then choose "Form" from the pull-down and then select the appropriate form from the pull-down on the right. If you are connecting to a different registration system to register or subscribe users, choose URL, and enter the URL you want the user directed to in the box on the right.
	179
	180	~~*IMPORTANT NOTE: If you are directing users to a third-party site for gating, you will need to make sure that that site or form enters a subscription for the user into the ONEcount API before returning the user to the site ONEcount is gating. Failure to submit that transaction will cause the user to get caught in a loop, because if the user is not subscribed to the asset, they will be sent to the form defined here.
	181
16.1	182	*~~IMPORTANT NOTE: If you will be using ONEcount to Gate the content on this URL using a registration or Paywall, change the Gating option to YES. NOTHING ELSE IS REQUIRED TO GATE THIS URL. IF YOU TYPE THE URL OF YOUR WEB SITE INTO THE URL BOX, IT WILL BE GATED WHEN YOU SAVE THIS PRODUCT!
14.1	183
16.1	184	(% style="color:#ff0000" %)*~~REALLY IMPORTANT NOTE: MAKE SURE YOU HAVE THE CORRECT URL AND HAVE SET UP A FORM FOR THIS PRODUCT PRIOR TO TURNING GATING ON. FAILURE TO SET UP A FORM WILL SEND USERS TO AN ERROR PAGE.
14.1	185
3.1	186
14.1	187	[[image:attach:URL-product-creation.png\|\|width="800"]]
6.1	188
14.1	189	Free Pass: If you set this option to "Enable," ONEcount will provide a box where you can determine how many free views of this URL a user may have before being forced to register or subscribe. Free pass is a number and a time period, such as 1 per week, 3 per month, etc. Setting a number and choosing Unlimited means ONEcount will only allow the user the specified number of views //forever.//
3.1	190
14.1	191	The Free Pass option is cross-device, meaning if a user visits once on their desktop computer and once on their mobile phone, ONEcount will count that as two views.
	192
	193	[[image:attach:Product-free-pass.png\|\|width="800"]]
	194
	195	If you are charging for access to this URL and have configured ONEcount for your Merchant Services provider, you may enter a price for access to this URL. Please note that this is a one-time payment. If you would like to charge an amount for a specified period of time, please visit setting up Packages in this documentation.
	196
3.1	197
14.1	198	[[image:attach:URL-product-URLS.png\|\|width="800"]]
6.1	199
14.1	200
	201	Now enter the URLs or URL fragments you would like protected. ONEcount uses a REGEX string match to match the URLs in the product against the URL in the user's web browser. You may enter any number of URLs or URL fragments into a single product, just click the plus sign next to the URL to add a new URL.
	202
	203	Note that ONEcount uses a string match, so in the example above, the fourth line will match ANY URL on ANY site if the URL contains /Chicago-Farmer/, while the third line will only match URLs on the site [[www.farmprogress.com>>url:http://www.farmprogress.com\|\|shape="rect"]] that are in the /Chicago-Farmer section of the site. Be careful of sites that can be accessed by http or https, and sites that do not require the www host name. These will require a more general version of the URL, such as farmprogress.com/Chicago-Farmer.
	204
	205	Once you have entered the URLs for this product, you can save it.
	206
	207
	208	2. Click "Save", and the Product will be saved.
	209
	210
16.1	211	[[image:attach:media_1404935573677.png\|\|style="vertical-align:middle"]]
3.1	212
10.1	213	You will receive a confirmation message, as shown above, inidicating the time the Product was saved.
	214	To return to the Products listing page, which will show your new Product in the alphabetical list, click on the Go Back button.
3.1	215
10.1	216	Note: You may cancel Product creation by clicking on the Go Back button before clicking Save. Doing so will bring you back to the Products listing page without creating a Product.
3.1	217
	218
6.1	219	----
	220
10.1	221	==== __Product Type: Section__ ====
6.1	222
16.1	223	[[image:attach:media_1404935663623.png\|\|style="vertical-align:middle"]]
3.1	224
10.1	225	To restrict access to an entire section of your site and/or to identify it for a dashboard, select Product Type: Section.
3.1	226
16.1	227	When you select "Section" from the "Product Type:" drop-down menu, you will see the message “Entire sections of the web site can be protected by specifying a part of the URL that every page in that section has in common. ((% style="color:#ff0000" %)DO NOT put in the intitial http:~/~/(%%))"
3.1	228
	229
6.1	230	~1. Enter the part of the URL that every page in the section has in common.
	231
16.1	232	[[image:attach:media_1404935899669.png\|\|style="vertical-align:middle"]]
3.1	233
	234	This will restrict access to all pages to access whitepapers in the gcnmedia.com site. (The URL that all pages have in common is the highest level page in the page hierarchy – all sub-pages below "/whitepapers" will be restricted, e.g. onecount/whitepapers/whitepaper1, onecount/whitepapers/whitepaper2, etc.)
	235
	236
10.1	237	2. Click "Save", and the section-type Product will be saved.
6.1	238
16.1	239	[[image:attach:media_1404936058551.png\|\|style="vertical-align:middle"]]
3.1	240
10.1	241	You will receive a confirmation message, as shown above, inidicating the time the Product was saved.
	242	To return to the Products listing page, which will show your new Product in the alphabetical list, click on the Go Back button.
3.1	243
10.1	244	Note: You may cancel Product creation by clicking on the Go Back button before clicking Save. Doing so will bring you back to the Products listing page without creating a Product.
3.1	245
	246
6.1	247	----
3.1	248
10.1	249	=== ATTACH Product TO A Package ===
3.1	250
12.1	251	Please refer to [[Packages - How to Create a Package Part 3: Attach / Remove / Create a Package>>doc:OD.Packages - How to Create a Package Part 3: Attach Remove Create a Product]] for directions on how to attach a Product to a Package.
3.1	252
6.1	253
	254
3.1	255	{{id name="End ScreenSteps Content"/}}
4.1	256	{{/layout-cell}}
	257
	258	{{layout-cell}}
6.1	259	{{panel title="On this page:"}}
7.1	260	{{toc maxLevel="4"/}}
6.1	261	{{/panel}}
4.1	262
6.1	263	{{panel title="More INVENTORY Documentation:"}}
16.1	264	{{expand title="Click here to expand..."}}
4.1	265	(% style="margin-left: 30.0px;" %)
	266	[[Inventory - Getting Started>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66180\|\|shape="rect"]]
	267
	268	(% style="margin-left: 30.0px;" %)
10.1	269	[[Quick Start Guide - Packages & Products>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66207\|\|shape="rect"]]
4.1	270
	271	(% style="margin-left: 30.0px;" %)
10.1	272	[[Packages - How to Create a Package Part 1: Create, Name, Attach Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66214\|\|shape="rect"]]
4.1	273
	274	(% style="margin-left: 30.0px;" %)
10.1	275	[[Packages - How to Create a Package Part 2: Package Terms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66234\|\|shape="rect"]]
4.1	276
	277	(% style="margin-left: 30.0px;" %)
10.1	278	[[Packages - How to Create a Package Part 3: Attach/Remove/Create a Product>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66253\|\|shape="rect"]]
4.1	279
	280	(% style="margin-left: 30.0px;" %)
10.1	281	[[Packages - How to Manage Packages>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66294\|\|shape="rect"]]
4.1	282
	283	(% style="margin-left: 30.0px;" %)
	284	[[Quick Start Guide - Questions and Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66310\|\|shape="rect"]]
	285
	286	(% style="margin-left: 30.0px;" %)
16.1	287	[[Question Builder - Create and Manage Questions>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66312\|\|shape="rect" style="text-decoration: underline;"]]
4.1	288
	289	(% style="margin-left: 30.0px;" %)
	290	[[Forms - How to Create a Form>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66345\|\|shape="rect"]]
	291
	292	(% style="margin-left: 30.0px;" %)
	293	[[Forms - How to Manage Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66370\|\|shape="rect"]]
	294
	295	(% style="margin-left: 30.0px;" %)
	296	[[Forms - How to Enable/Disable Lookup/Login Page>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66386\|\|shape="rect"]]
	297
	298	(% style="margin-left: 30.0px;" %)
	299	[[Brand - How to Create and Manage Brands>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66391\|\|shape="rect"]]
	300
	301	(% style="margin-left: 30.0px;" %)
10.1	302	[[Products - How to Create a Product>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66411\|\|shape="rect"]]
4.1	303
	304	(% style="margin-left: 30.0px;" %)
10.1	305	[[Products - How to Manage Products>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66435\|\|shape="rect"]]
4.1	306
	307	(% style="margin-left: 30.0px;" %)
	308	[[Promo Codes - How to Create and Manage Promo Codes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66445\|\|shape="rect"]]
	309
	310	(% style="margin-left: 30.0px;" %)
10.1	311	[[Package Status - How to Create and Manage Package Statuses>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66479\|\|shape="rect"]]
4.1	312
	313	(% style="margin-left: 30.0px;" %)
	314	[[Source Codes - How to Create and Manage Source Codes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66463\|\|shape="rect"]]
	315	{{/expand}}
6.1	316	{{/panel}}
	317
	318
	319
	320
	321
	322
	323
	324
	325
	326
16.1	327
4.1	328	{{/layout-cell}}
	329	{{/layout-section}}
	330	{{/layout}}