Getting started with Spree - Revision history

Scott at 09:21, 28 November 2010

2010-11-28T09:21:12Z

Scott at 09:11, 28 November 2010

2010-11-28T09:11:46Z

Scott at 08:26, 28 November 2010

2010-11-28T08:26:11Z

Scott at 08:10, 28 November 2010

2010-11-28T08:10:28Z

Scott at 08:03, 28 November 2010

2010-11-28T08:03:24Z

Scott at 07:50, 28 November 2010

2010-11-28T07:50:15Z

Scott at 07:41, 28 November 2010

2010-11-28T07:41:18Z

WikiSysop at 21:28, 26 November 2010

2010-11-26T21:28:13Z

WikiSysop: moved Spree to Getting started with Spree

2010-11-26T21:27:58Z

moved Spree to Getting started with Spree

Scott: start adding spree page

2010-11-26T18:04:10Z

start adding spree page

New page

== Getting started for Spree ==

[[Image:Spree.png]]

It's really easy to get up and going with Directed Edge's recommendations and [http://spreecommerce.com/ Spree]. We've got a plugin that does almost all of the work for you.

== Prerequisites ==

* You're using Spree version 0.11 or lower. We don't yet support Spree 0.3, but [mailto:info@directededge.com '''let us know'''] if you've already made the jump to 0.3 and we'll let you know as soon as it's ready!

* You know a teensy bit about customizing the templates for your shop.

* You've got a Directed Edge account. [http://www.directededge.com/signup-ecommerce.html '''Sign up here!''']

← Older revision		Revision as of 09:21, 28 November 2010
Line 56:		Line 56:

	[[Image:Spree-basket-recommendations.png\|600px]]		[[Image:Spree-basket-recommendations.png\|600px]]
		+
		+	=== Personalized recommendations ===
		+
		+	Here we branch out a little from our helper and make the template match the other products shown on the index page. However, altogether, this is still a very minor modification. This one goes in <tt>app/views/products/index.erb.html</tt> and the '''full text of our template is [[Getting started with Spree/Products/Index\|here]]:
		+
		+	[[Image:Spree-personalized-recommendations.png\|600px]]
		+
		+	=== CSS ===
		+
		+	To get the recommendations to show up the way we wanted them to, we also added a few lines of CSS to our site template:
		+
		+	<source lang="css">
		+	#product-details .edgy-related {
		+	width: 310px;
		+	}
		+
		+	#recommenadtions {
		+	padding: 2em;
		+	}
		+
		+	.list-type {
		+	clear: both;
		+	margin-left: 10px;
		+	}
		+
		+	ul.product-listing {
		+	margin-top: 0.5em;
		+	}
		+	</source>
		+
		+	== Questions? ==
		+
		+	Just [mailto:info@directededge.com drop us a line] if you've got any questions about how to get up and going or anything else we can help with!

← Older revision		Revision as of 09:11, 28 November 2010
Line 26:		Line 26:

	== Displaying recommendations ==		== Displaying recommendations ==
		+
		+	Now, on to displaying recommendations. This is a teency bit less cookie-cutter. There are three types of recommendations supported at present, personalized recommendations, related products and basket recommendations.
		+
		+	We provide a helper that you can use from your templates to display the recommendations:
		+
		+	<source lang="ruby"><%= edgy_related_table :horizontal, :max_results => 4 %></source>
		+
		+	That provides a really simple table with the number of recommendations specified by <tt>:max_results</tt>. Let's go ahead and jump into putting that in place.
		+
		+	=== Related products ===
		+
		+	In your Spree root directory you probably already have a theme that you've customized in <tt>vendor/extensions/theme_[your theme name]</tt>. We'll start with the product template under there in <tt>app/views/products/show.erb.html</tt>.
		+
		+	You just need to add the helper from above:
		+
		+	<source lang="ruby"><%= edgy_related_table :vertical, :max_results => 4 %></source>
		+
		+	'''You can see the full text our our lightly modified default template [[Getting started with Spree/Products/Show\|here]].'''
		+
		+	[[Image:Spree-related-products.png\|600px]]
		+
		+	=== Basket recommendations ===
		+
		+	Now we'll do the same with basket recommendations, but featuring a horizontal layout. The line we add to <tt>app/views/orders/_form.erb.html</tt> is:
		+
		+	<source lang="ruby"><%= edgy_related_table :vertical, :max_results => 4 %></source>
		+
		+	Again, the '''full text of our modified template is [[Getting started with Spree/Orders/Form\|here]].'''
		+
		+	[[Image:Spree-basket-recommendations.png\|600px]]

@@ Line 15: / Line 15: @@
 There are a few bits and pieces that cover different layers that have to be installed to get things going in Spree, each a little more specific.  There's a Ruby-specific gem, a Rails-specific plugin and finally a Spree-specific extension.
-Go to your shop's root directory and run the following commands:
+Go to your shop's root directory and run the following commands, and you'll want your Directed Edge [http://www.directededge.com/signup-ecommerce.html account info] handy.
 {{Shell|sudo gem install directed-edge}}
 {{Shell|./script/plugin install {{URL|github.com/directededge/acts_as_edgy.git}}}}
 {{Shell|./script/extension install {{URL|github.com/directededge/acts_as_edgy_spree.git}}}}
 {{Shell|rake edgy:configure}}
-* Do an initial export of your Shop's purchase data:
+Now your initial data export to Directed Edge is complete!
 == Displaying recommendations ==

@@ Line 23: / Line 23: @@
 * Install the <tt>acts_as_edgy</tt> Rails plugin:
-{{Shell|./script/plugin install https://github.com/directededge/acts_as_edgy.git}}
+{{Shell|./script/plugin install {{URL|github.com/directededge/acts_as_edgy.git}}}}
 * Install the <tt>acts_as_edgy_spree</tt> Spree extension:
-{{Shell|./script/extension install https://github.com/directededge/acts_as_edgy_spree.git}}
+{{Shell|./script/extension install {{URL|github.com/directededge/acts_as_edgy_spree.git}}}}
 * Configure the plugin with your Directed Edge account info (from your [http://www.directededge.com/signup-ecommerce.html sign-up])

@@ Line 13: / Line 13: @@
 == Installing the plugin ==
-Go to your project's source directory and do the following:
+There are a few bits and pieces that cover different layers that have to be installed to get things going in Spree, each a little more specific.  There's a Ruby-specific gem, a Rails-specific plugin and finally a Spree-specific extension.
 * Install the Directed Edge gem:
@@ Line 34: / Line 36: @@
 {{Shell|rake edgy:export}}

@@ Line 5: / Line 5: @@
 == Prerequisites ==
-* You're using Spree version 0.11 or lower.  We don't yet support Spree 0.3, but [mailto:info@directededge.com '''let us know'''] if you've already made the jump to 0.3 and we'll let you know as soon as it's ready!
+* You're using Spree version 0.11.2 or lower.  We don't yet support Spree 0.3, but [mailto:info@directededge.com '''let us know'''] if you've already made the jump to 0.3 and we'll let you know as soon as it's ready!
 * You know a teensy bit about customizing the templates for your shop.

← Older revision		Revision as of 07:41, 28 November 2010
Line 10:		Line 10:

	* You've got a Directed Edge account. [http://www.directededge.com/signup-ecommerce.html '''Sign up here!''']		* You've got a Directed Edge account. [http://www.directededge.com/signup-ecommerce.html '''Sign up here!''']
		+
		+	== Installing the plugin ==
		+
		+	Go to your project's source directory and do the following:
		+
		+	* Install the Directed Edge gem:
		+
		+	{{Shell\|sudo gem install directed-edge}}
		+
		+	* Install the <tt>acts_as_edgy</tt> Rails plugin:
		+
		+	{{Shell\|./script/plugin install https://github.com/directededge/acts_as_edgy.git}}
		+
		+	* Install the <tt>acts_as_edgy_spree</tt> Spree extension:
		+
		+	{{Shell\|./script/extension install https://github.com/directededge/acts_as_edgy_spree.git}}
		+
		+	* Configure the plugin with your Directed Edge account info (from your [http://www.directededge.com/signup-ecommerce.html sign-up])
		+
		+	{{Shell\|rake edgy:configure}}
		+
		+	* Do an initial export of your Shop's purchase data:
		+
		+	{{Shell\|rake edgy:export}}

← Older revision		Revision as of 21:28, 26 November 2010
Line 1:		Line 1:
−	~~== Getting started for Spree ==~~
−
	[[Image:Spree.png]]		[[Image:Spree.png]]

← Older revision	Revision as of 21:27, 26 November 2010
(No difference)