WordBay


The quickest way to start earning from Wordpress and eBay!

WordBay is free to use, but it takes TIME to produce something like this. All donations gratefully received!
Subscribe to stay up-to-date with new versions of WordBay.

Download latest version of WordBay.

  • Pages

    • About WordBay
    • Customising WordBay
    • Download latest version of WordBay
    • Features of WordBay
    • Installing and configuring WordBay
      • DEPRECATED: Installing and configuring WordBay
    • WordBay - marketing your niche site
    • WordBay bugs and to-do’s
  • Search

  • Archives

    • October 2008
    • September 2008
    • July 2008
    • June 2008
    • May 2008
    • April 2008
  • Subscribe

    • Register
    • Log in
    • Feed - RSS
  • DEPRECATED: Installing and configuring WordBay

    NOTE - these installation instructions only apply to the old 0.7BETA version. The new 0.5BETA PLUGIN version is installed like any other WordPress plugin and the keyword tags are used as detailed below (scroll down to Search Keywords). I will soon be putting up instructions for the new version, so please IGNORE the first part of these instructions unless you want to try out the old version.

    Firstly, in these instructions I am assuming you want to set up a standalone eBay niche site. If you want to use it with an existing WordPress installation then it’s even simpler, and you can skip the first 2 steps. These steps are outside the scope of this help, there is plenty of info on these subjects elsewhere and a working knowledge of WordPress would be useful. It also helps to join eBay ( ;-) ) and you MUST be a member of the eBay Partner Network if you want to earn money from WordBay!

    Hosting set-up

    1. Get hosting and get a domain that you want to use for your niche site. You may have the former already, but if not I can recommend BlueHost – I have used them for over a year and am very happy with them. Another popular host is GoDaddy, who also currently offer .info domains for $1.19 (bargain, or what!?). That’s where I bought www.used-musical-instruments.info, which I will use throughout as my example.

    2. Install the latest version of WordPress in the root directory of your site, or in a subdirectory of an existing site if you prefer. This should be very simple through the SimpleScripts or Fantastico utilities in your control panel.
    During installation you will have given your site a name and specified other details. I called my site Used Musical Instruments and added the catchline Previously enjoyed musical instruments… going for a song! (very original, I know!). Your WordPress dashboard can then be accessed via http://yoursite.com/wp-admin.

    I would also immediately suggest the following adjustments to your WordPress setup:

    i. Options (or Settings) -> Permalinks - choose Custom and use the following format: /%year%/%postname%/
    This will ensure you have SEF urls – though don’t do this on an existing site if you hadn’t already! You’ll mess up all your links!

    ii. Install a sitemap generator like this one and set it up so that Google is kept up to date about your site, and that your pages are indexed as often as possible, since they will frequently be changing.

    iii. Settings/Options -> Discussion – untick “Allow comments” – you probably don’t want user comments generally – there’ll be more spam than it’s worth.

    WordBay setup

    3. Download and install the free Wordpress Evanescence theme. I am using this for our example site – you can always change it later, or use a different one straight away if you know what you are doing. Evanescence suits us because it is free, very simple and has only one sidebar and is a liquid design, which we need, at least for the out-of-the-box WordBay installation. You can fiddle with the template later, let’s get it working first! Remember to activate the new template in the Design/Themes section!
    If you are using an existing site you will want to skip this step and get to work adapting WordBay for your own site design – there is some basic info on this later, but there may be a bit of stress here!

    4. OK, this is the bit where we install WordBay. Are you ready?! Copy the file WordBay.php and WordBay-config.php to the same directory as your template, in our example it’s wp-content/templates/evanescence-12/. Copy buy.php to your root directory (or anywhere you like, just remember to change the link url when configuring WordBay). And that’s it!

    5. Now, let’s just see if it works first. Write a new Page (not post) in Wordpress. Let’s call it Used Pianos and let’s write a few lines of text as our content. We are also going to add the following code below the content: [wordbay]used piano[/wordbay]. This is our search code, and is pretty self-explanatory, but we will look at this in more detail later.


    Also, we want to change the page template so it uses the new WordBay template. So go down to Page Template and choose WordBay (not WordBay-config!) from the drop-down menu. If it’s not there, you haven’t put the WordBay.php and/or the WordBay-config.php file in the right directory, simple as that!

    6. Now you can go to your live site, in my case www.used-musical-instruments.info and see what you have! Your front page shows the latest post (which is just a default post if this is a new WordPress installation) – we’ll change this in a minute to display the page we want. But in the right hand Pages menu, you should have a new entry with Used pianos or Rubber ducks, or whatever you called your page. Click on that and you should get something like this:

    …and there you go! A lovely page of products pulled down from eBay. If there isn’t, check the search terms you used first of all – maybe there are no products. Oh, and the colours and layout probably won’t be the same - this was an early version of the template.
    Notice that there are TWO panels – that’s why we went for a liquid layout. So on the same page you can have listings both from, say, UK eBay and US eBay, which increases your chances of click-through. The two panels are currently hard-coded into WordBay, i.e. if you want just one (or three!) you will have to do some hacking of the code! The configuration for the two panels is explained below – you MUST configure WordBay immediately, especially if you want to ensure you will get paid!

    7. You also want to have a default page displayed on your home-page, right? This isn’t a blog probably, so the latest posts aren’t much use, your site will most likely be made up entirely of pages. Just go into Wordpress Settings -> Reading and under Front page displays check the A static page radio button, and choose the page you made, or any other page you decide on in future. It is up to you what your home page will be.

    8. …And that is how you make the whole site! Just keep creating new WordPress Pages with new keywords! You will probably want to create a hierarchy by choosing Page Parent when creating a new page.

    This is more of a display thing, but the SEF urls also reflect this hierarchy. So under my Used Pianos page I might create a page called Used Yamaha Pianos, with the code [wordbay]used yamaha piano[/wordbay]. In the page editor I would select as Page Parent, “Used Pianos”, and this would show up in the page menu as here:

    As you can see, it is very simple to quickly set up a site with lots and lots of categories and subcategories and populate it with lovely products to sell!

    BUT WAIT – this is fine if all you want to do is just display stuff from eBay! But if you want to earn money from it, you MUST configure WordBay, otherwise any earnings go to the author of WordBay, who it must be said, will not kick up a great fuss about it!

    WordBay configuration

    WordBay has not been made in the form of a “proper” WordPress plugin – maybe we can do that one day, but although there may be one or two ugly hacks in there I think this is a nice, simple implementation (besides, I haven’t got the faintest idea how you write a “legal” WordPress plugin). It does mean though that configuration is not done through the WordPress admin backend, but rather by editing WordBay-config.php. However, we have made this file into a WordPress template, so it CAN be edited from the backend. This also means that a new version of WordBay can be installed without affecting your parameters. So…

    1. Go into Themes/Design (depending on your WP version) and Theme Editor. Select WordBay-config.php from the right-hand menu. The config file will open up in the editing window and you can make changes here. If you mess anything up you can always recopy the original config file from the installation.
    2. The first thing you will see are the WordBay CSS classes. I have put them here so we don’t have to change the main theme stylesheet, but once you get into customizing your site you might want to cut-paste these into the main stylesheet. These are currently set so that WordBay works with the Evanescence theme. Scroll past these until you get to <!– End of WordBay classes –> and here you should find /* WordBay - user editable parameters */.
    3. Now, these are the parameters you need to change. Tell you what, I think there are enough comments in the code itself to get you going. If there are any problems, let me know here and we will clarify things. If you are not familiar with editing php, well, it’s simple, just be careful to only change the code in question. E.g. if you want to change ‘$first_location=1;’ (items dispatched from US – for the left panel) to ‘$first_location=3;’ (dispatch from UK) then make sure you ONLY change the number, don’t overwrite the ‘;’ and if there are inverted commas, make sure they are left alone.
    4. Generally, the first section of parameters relates to the obfuscation process, whereby you specify where the “buy.php” (obfuscation routine) is located and which words you want rover and ebay to be substituted with. I have put “buy” and “cheap” – who knows, maybe this helps with SEO :). If you want to change this, you need to change it in the buy.php, so don’t worry about it for now. I will try to explain obfuscation elsewhere at some point.
    5. The second and third sections configure the left and right-hand panels respectively and the parameters are exactly the same for the left - $first_xx - and right - $second_xx – panels (why didn’t I just call the variables $left and $right to avoid confusion? Very good question…) As I said, these are hopefully explained adequately in the config file itself, but if you have any questions, post them here.
    There is a little confusion (in my head at least) regarding the various parameters relating to the country, so feel free to fiddle with these until you get the proper country, currency and site etc. working.
    Also you NEED to get a campaign id from eBay Partner Network and insert it in $first/second_campid, otherwise revenue will continue to go to the WordBay author! (who will say, “thank you very much”). Once you have done this, please consider setting the $generosity variable to something, well, symbolic (more than 0!) at least. In doing so a small percentage of your impressions will go to the author of WordBay (me), who has invested a lot of time in the project, when I really should have been doing something else, and it would warm the cockles of my heart to see a few pennies as a result of my hard work!

    Well, that’s pretty much all we need to do! You should try a few clicks and track them in the eBay PN dashboard to make sure everything is working. Otherwise, it’s time to get building your site!

    Search keywords

    As you probably figured out, the tags [wordbay]fish[/wordbay] inserted anywhere in your page body text will search for all products with “fish” in the title. However, it is difficult to target searches with just this, so here are some more tips:

    [wordbay]grand piano[/wordbay] - this is logical AND – space between the words means all products with “grand” and “piano” in the title.
    [wordbay]”grand piano”[/wordbay] – exact phrase match – means the exact phrase “grand piano” must be found in the product title
    [wordbay]piano -yamaha[/wordbay] – AND NOT – searches for all occurrences of ”piano”, but minus sign excludes any titles with “Yamaha”
    [wordbay](piano,“mouth organ”)[/wordbay] – OR – brackets apply logical OR (also AND/OR I think) to all items in the brackets, whether single keywords or phrases, i.e. this will find all items with either “piano” OR “mouth organ”.

    By the way, supposedly you are not suppose to put spaces after commas or minus signs, so it’s best to stick to that just in case. Here are a couple more examples:

    [wordbay](“used piano”,“used guitar”) -yamaha[/wordbay] – find all items with either “used piano” or “used guitar” in the title, but excluding “yamaha”.
    [wordbay]”used piano” –(stool,cover,music)[/wordbay] – this will search on “used piano” BUT will exclude “stool” and/or “cover” and/or “music”. This type of search is especially useful as it allows you to eliminate most of the junk/irrelevant items like “used piano stool” and narrow the search down to just actual pianos!

    There is more help on the relevant eBay page.

    Well, what are you waiting for!? Get building and get earning!!

    28 Responses to “DEPRECATED: Installing and configuring WordBay”

    1. WordBay » First BETA version of WordBay released!, on April 13th, 2008 at 3:04 am Said:

      […] Installing and configuring WordBay […]

    2. Daniel, on April 16th, 2008 at 1:18 pm Said:

      Thanks for this great Plugin!

      Is posibly to put ‘ending soon first’ in the rss call?

      Thanks
      Daniel

    3. admin, on April 16th, 2008 at 2:45 pm Said:

      Good question. I never thought about it - aren’t items already automatically sorted so the soonest ending time is first? I will look into it and let you know! This IS a parameter in the RSS call but I haven’t played with it yet.

    4. admin, on April 16th, 2008 at 3:45 pm Said:

      Hey, Daniel, I have looked into it and I am pretty sure items already are listed “soonest ending first” - can you confirm this?

      Just to add - it’s true that I have not set these parameters, so I will set them just in case in the next version of WordBay. In the meantime, if you know what you are doing, you should add the parameters “&fsoo=1&fsop=1″ to the variable strings - $first_otherparams and $second_otherparams in the wordbay-config.php file. I tried this and couldn’t be sure there was any difference, but feel free to try.

    5. mr.omneo, on April 20th, 2008 at 3:58 pm Said:

      is there anyway to add the [wordbay][/wordbay] tags within blog posts or do they have to be pages?

    6. mr.omneo, on April 20th, 2008 at 4:44 pm Said:

      Sorry to be a pain but I just noticed, i have added 2 pages but the heading on the page I created second has the same “Buy Cheap” details as the first.. any idea why that might be?

    7. admin, on April 21st, 2008 at 1:47 am Said:

      Hi Mr. Omneo. In answer to your first question, unfortunately, no, this version of WordBay only works by using a custom template - you can’t set a custom template for posts so… no listings in posts.

      However, I am working on a “proper” plugin version of WordBay (in fact a BETA version is pretty much ready, I’m hoping to roll it out today) in which you CAN insert the wordbay tags in blog posts too.

      In answer to your second question - no pain! But how do you mean exactly the same “Buy cheap…” details? It is supposed to insert the page title and the country, i.e. “Buy Cheap: [Page title] from [country] eBay”. Is it not following that pattern? Let me know more details and I’ll try to help.

      I will actually be getting rid of this feature for the plugin because not everybody wants this hard-coded in like this, and you can always add the text yourself in the page content.

    8. mr.omneo, on April 21st, 2008 at 6:51 am Said:

      Hi Mark,

      I just read about the wordpress plugin so I’ll be giving that a whirl later this week.

      With regard the second point, I was trialling it at http://blog.omneo.co.uk and added 2 pages. If you have a look you’ll see the heading for both is Buy Cheap Shishas from [Country] eBay… I can see in the code that it’s supposed to pick up the page title but for some reason it doesn’t.. had me stumped!

    9. admin, on April 21st, 2008 at 2:02 pm Said:

      Oh yeah.. weird, it says Shisha, even on the iPod page. Now THAT is strange. I don’t want to go straight out and shift the blame off my programmatic work of art, but it’s working fine on my Used Musical Instruments page.

      I’ve had another look at the code and I’m wondering if this might fix it:

      find the line in the WordBay-config.php that says $pagetitle = get_the_title (); and replace it with these two lines:

      global $post;
      $pagetitle=get_the_title($post);

      The worst it can do is work exactly the same, but it might help solve the problem - let me know!

    10. mr.omneo, on April 23rd, 2008 at 4:31 pm Said:

      Hey Mark,

      tried amending that line but no joy.. it’s most strange… of course the first thing I did when i noticed it was check your musical instruments blog and saw it worked fine, that’s what made it all the more puzzling…

      No matter, going to give the plug-in a whirl, will let you know if anything odd happens :)

    11. Digital Kitchen Scales, on April 24th, 2008 at 3:41 pm Said:

      Hi - I just downloaded the zip and there was no WordBay-config.php file in it - not sure why not, but I’m looking forward to getting the full plugin.

      Thanks
      M

    12. money maker, on April 25th, 2008 at 11:24 am Said:

      This plugin looks great, I really hope it works with my templete ;)

    13. shawn, on April 30th, 2008 at 9:50 am Said:

      Listings on my site are not showing the dollar amount, just the change.(.50 instead of $10.50, etc.) also when a listing is clicked on it just goes back to my site instead of ebay. do you know why this is?

      Thanks.

    14. admin, on May 5th, 2008 at 12:03 am Said:

      Hi people, apologies for not getting right onto the issues you have mentioned. I have been on a short holiday but am back now and promise to have a look as soon as possible. Once again, the feedback is much appreciated but I also want to reiterate that this IS a beta version, there could be any number of bugs, so don’t start doing anything with this plugin which is business-critical! Please play with it and keep giving feedback. Will return with some solutions soon hopefully!

    15. admin, on May 5th, 2008 at 6:43 am Said:

      OK, just to let you know that I am onto this issue with content not being displayed on NON-listings pages/posts. I think it’s a very simple oversight on my part, and if it’s as simple as I think I will hopefully have a new version out in 24 hours or so.

    16. admin, on May 6th, 2008 at 3:11 am Said:

      OK, as I hope you figured out, the major bug with content not displaying has been fixed. I wanted to turn my attention to these other two issues people mentioned:

      Digital Kitchen Scales (nice name :) ) - my apologies, I caused some confusion with bringing out a new version of WordBay but leaving the old instructions up. There is now no longer a config file, the configuration is done through the WordPress dashboard - hope you figured that one out!

      Shawn - re: the currency display issue, the eBay feed is a little quirky in this respect. Try fiddling with some of the settings: I selected Location for dispatch as United States and eBay site ID as eBay.com and this displays dollars as “US $0.99″. Would this suit you?

      As for clicking on listings returning you to your own site - you mean you are actually clicking on an item and it’s not taking you to the eBay item? Which page on your site is it taking you to? It sounds a bit like an .htaccess problem. Do you have permalinks activated?

    17. shawn, on May 6th, 2008 at 9:56 am Said:

      Mark

      I do have permalinks activated. I downloaded the newer version of Wordbay. Now I get a 404 error page when I click on an item. I have tried this plugin on about six different sites so it is not just concentrated on one. Not sure why it is doing it.

      It would be great if the plugin displayed the full dollar amount instead of $0.99.
      I would not want my visitors to think I am displaying inaccurate information. If they click on an auction that says $0.99 and it is really $299, they might think I am trying to trick them. I know using the feed word press plugin can display the auctions with the full price, but yours looks so much better and appears to use nofollow. I have heard guys say they went to bans because they can’t use nofollow with the RSS feed plugin. You have a great plugin that I feel can compete with bans if you can get the bugs worked out.

      Thanks.

    18. shawn, on May 10th, 2008 at 9:41 am Said:

      Hi Mark I hope this will help in trying to figure out what is going on. This is what the link looks like on the ebay items. When I click on an item I get a 404 error. I
      looked at other sites that are running wordbay and the links don’t look like this. Do you have an hints on how I can fix this?

      Thanks

      http://bluewidgetsexample.com/wp-content/plugins/WordBay/buy.php?buyurl=aHR0cDovL2J1eS5jaGVhcC5jb20vYnV5LzEvNzExLTUzMjAwLTE5MjU1LTAvMT9jYW1waWQ9NTMzNTkwMzU5NSZjdXN0b21pZD1odHRwOi8vdG9wY2JyYWRpb3MuaW5mby9jYi1yYWRpb3MvJnRvb2xpZD0xMDAwNSZtcHJlPWh0dHAlM0ElMkYlMkZjZ2kuY2hlYXAuY29tJTJGQU0tRk0tQ0ItQU5URU5OQS1TUExJVFRFUi02MTFfVzBRUWl0ZW1aMzMwMjMzNTEzMjI0UVFjbWRaVmlld0l0ZW1RUXNzUGFnZU5hbWVaUlNTJTNBQiUzQVNSQ0glM0FVUyUzQTEwMg==&buy=buy&cheap=cheap

    19. shawn, on May 10th, 2008 at 1:42 pm Said:

      Mark,

      I don’t mean to be a pain in the neck, but this is driving me nuts! lol. I will try to expand on the situation more. On a normal site using wordbay when I mouse over the item listing it shows a link like the one above but when you click on it in redirects to the product listing link. Mine does not, it trys to go to that super long link and then I get the 404 error. Here is a quick site I threw up to help show you the issue. Maybe there is something I am doing wrong but I don’t know what it could be. I have tried it with several sites and themes. http://topcbradios.info. I hope by looking at the site it will help you take me in the right direction.

      Thanks.

    20. admin, on May 14th, 2008 at 1:26 am Said:

      Sorry once again for being so slow to respond - WordPress isn’t sending me new message notifications so I didn’t notice your comments.

      OK, I can imagine this problem is really frustrating! Just looking at your site, even trying to navigate to the base link, without any parameters: http://topcbradios.info/wp-content/plugins/WordBay/buy.php gives the 404 error, which it shouldn’t, it would display a blank page. WordPress tends to nicely catch invalid links with 404, which begs the question, why would this link be invalid?

      Stupid question, is the buy.php file actually IN the wp-content/plugins/WordBay directory?

      Second question, is the plugin directory definitely called WordBay (with the caps written just so)? And not “wordbay” (small caps) or “Wordbay” (no second small cap)? Web servers are often case-sensitive, unforgivingly so…

    21. shawn, on May 14th, 2008 at 5:27 pm Said:

      That explains it! Boy do I feel dumb. I never had a directory. I just loaded up the plugin and activated it. It had all the options and functioned fine, it just did not link right. Thanks Mark, works like a charm.

    22. admin, on May 15th, 2008 at 6:07 am Said:

      Brilliant - I’m always glad when it’s a simple explanation. And it’s partly my fault, because I haven’t documented the plugin version yet, so haven’t explained installation very clearly. Anyway, let me know how you get on!

    23. Joni Mueller, on May 22nd, 2008 at 12:04 pm Said:

      I’ll gladly hit your PayPal link if you can tell me how to set this up. What is the function I call to the sidebar? The readme is not clear on this. How/where would I enter my eBay userid? There’s no config file in my distro (downloaded today). Is this depracated?

      I see the options page, but I can’t implement the plugin. Running WP 2.5.1, BTW. Here’s what I put in the sidebar b/c I couldn’t figure out what else to put there, substituted [ for the PHP left and right carets.

      [?php if (function_exists(’WordBay)) { ?]
      [li id=”ebay”]
      <?php WordBay(); ?]
      [/li]
      [?php } ?]

    24. Joni Mueller, on May 22nd, 2008 at 12:10 pm Said:

      So it looks like this is just a search tool for eBay? I still cannot figure out how to make the listings USER specific.

    25. KiwiChris, on May 23rd, 2008 at 6:28 am Said:

      I had exactly the same problem but thankfully figured it out pretty fast yet I really recommend that you change the zip file so the needed files are already inside a WordBay dir with instructions for them to upload to plugin dir as is…

      I’m sure you will have many more coming across the same simple problem and some not even noticing that the links don’t work as I almost did!!! :-(

      Great plugin by the way and you bet I’ll be donating some $ your way.

    26. admin, on May 26th, 2008 at 12:54 am Said:

      Hey, thanks for the feedback guys, and sorry for not getting back - I have been on holiday :/

      Apologies - I REALLY need to get the instructions for WordBay updated to avoid confusion, and also, as you rightly say Chris, to pack the zip file so it is clear that they need to go in a subdirectory. I will try to get all this done asap, but it might take a few days.

      Joni, in what way would you like it to make the listings user specific? I am toying with some kind of option to harvest people’s search terms and customise the display slightly in that way, but I want to make sure this version is working properly. No, you can’t use the function in the sidebar like that currently, at least I haven’t tried it, but it is another thing I will think about.

    27. Joni Mueller, on May 26th, 2008 at 4:56 am Said:

      Well by user-specific, I mean if I am running ebay auctions, I want to display only MY auctions. Right now, from what I gather, this plugin just searches by item keywords, correct?

      And the auctions I’d be listing would always be with eBay MOTORS. So wonder if any of my scenarios would fit so that I could use this plugin. :)

    28. admin, on May 28th, 2008 at 3:56 am Said:

      YOUR auctions, as in, stuff you are selling?

      I could add a seller ID field, I guess - will put it on the wishlist. But then it would be fixed for your whole site, you could only display listings from that one user.

      At the moment it’s not possible, though, sorry…

    Leave a Reply