WP-CRM: a basic CRM built with WordPress

WP-CRM: a basic CRM built with WordPress

WP-CRM is a WordPress system for creating a basic Contact Manager / CRM.  The system requires a combination of plugins and a theme.  It was inspired by the great work David Yeiser did with WP-Contact Manager, and by 37signals Highrise.

Features:

  • Add contacts from the front end of WordPress – no need to go to the admin screen.
  • Associate an image with each contact.
  • Assign each contact to a company… or don’t.
  • Create a note history for each contact.
  • Clickable email and website links.
  • Google map contacts address.
  • Dial a phone number (works on cell phones with internet browsers).
  • Fully hcard / vcard compatible.
    • To check out this feature, install Tails for Firefox; it will show you the hcard data and allow you to export a contact to Outlook.
  • Written with BluePrint CSS.

>>Click here to see the demo<<

(Contact creation has been disabled in the demo, but you can add notes.)


D E V E L O P E R S   W A N T E D

WP-CRM was built rather quickly using existing plugins and some creativity. Imagine what would happen if a few plugin developers got together and focused on making a full-featured CRM built on WordPress.

Well… stop imagining, and start coding!

SlipFire is looking for a few good plugin developers to help build the world’s best (some may say, first):
Open-source, stable, secure, themable, pluggable CRM.


If you’re interested please
contact us here.


Installation Instructions

Setup is a little bit of work, but once it’s done you have a cool , customizable CRM.  Remember, if it were easy… everybody would be doing it!

For WP-CRM to work properly, you need a fresh install of WordPress, the theme and a few plugins:

  1. Upload and activate the theme and plugins (did I really need to tell you that?).
  2. Though you will be creating contacts on the front end, you still need to create your companies on the back end. Go to MANAGE – CATEGORIES, and create a category called “none” (without the apostrophes). This will be for contacts that have no company associated with them.  If you like,  you can also create a few companies here as well… or you can do it later.  Each company is just a standard category.
  3. Click on the tab “TDO Mini Forms”.  Now we’re going to create the add contact form.  You will immediately see “Error: No default author set!” Click on “Create dummy user for default author automatically”.
  4. Click on “Form 1″, these are the general options for your form.
    • Change form name to “Add Contact”.
    • Change default category to “none”.
    • Since this is your CRM and you’re not going to let just anybody create a contact, you can check “enable moderation”.
    • Change widget instances to “25″.  This is the amount of custom fields you can have on this form.  We’re only going to use 15 of these, so you can use the remaining 10 for other fields if you like.  But you’re going to have to edit the theme to show them.
    • Click “Save”
  5. Now let’s create the form!
    1. Click on “Form Widgets” from the submenu.  You may recognize this layout. This plugin was created so that it uses the familiar widget layout… very slick!
    2. Scroll down to the bottom of the screen, and where it says “Custom Field Widgets”, select 25 from the dropdown menu and click “save”
    3. Now scroll back up and drag “Custom Fields 1″ to the widget.  And then place “Custom Fields 2″ underneath it.  Now, pay attention here; place “Categories 1″ next.  Continue until your layout looks like this:
      customfieldslayout.jpg
    4. Now we need to set the values for each field.  Click on the icon to the right of “Custom Fields 1″ and the options screen should pop up.  Fill in the values per the table below.  When you’re done with each field, click the “X” at the top of the options screen to close the screen, and then click “Save Changes” after you adjust each field, just to make sure you don’t lose your work.VERY IMPORTANT:
      • The Custom Field Key must be typed exactly as shown, or it won’t work.
      • You must set First Name and Last Name as Required fields.
      Custom Field # Title Custom Field Key Type Size Select button choice Other
      Custom Field 1 First Name first_name text field 30 text (no option)
      Custom Field 2 Last Name last_name text field 30 text (no option)
      Categories 1 Company (no option) (no option) (no option) (no option)
      • “overwrite default categories:check
      • “list of categories to exclude”: 1
      Custom Field 3 Title title text field 30 text (no option)
      Custom Field 4 Address Line 1 address1 text field 30 text (no option)
      Custom Field 5 Address Line 2 address2 text field 30 text (no option)
      Custom Field 6 City city text field 30 text (no option)
      Custom Field 7 State state text field 2 text (no option)
      Custom Field 8 Postal Code postal_code text field 10 text (no option)
      Custom Field 9 Mobile mobile_phone text field 30 text (no option)
      Custom Field 10 Home home_phone text field 30 text (no option)
      Custom Field 11 Work work_phone text field 30 text (no option)
      Custom Field 12 Fax fax text field 30 text (no option)
      Custom Field 13 Other other text field 30 text (no option)
      Custom Field 14 (leave blank) email text field 30 email (no option)
      Custom Field 15 Website website text field 30 text
      • “default value”:http://
      • choose “url”
      Content (no option) (no option) (no option) (no option) (no option)
      • “Title of Post”: uncheck “show
      • “Content of Post”: uncheck “required”
      Tags No configuration neccessary
      Upload Files (no option) (no option) (no option) (no option) (no option)
      • “Allow File Types:” .jpg .gif .png
      • Check: “Use filename as post title”
      • “Max File Size:” 100000
      • “Add download link to post content:” uncheck
      • “Add download link as custom value:” uncheck
      • Url of Uploaded area:”http://[your domain name]/wp-content/uploads/
    5. We need to create a WordPress page to put the cool form you just setup:
      • WRITE – PAGES
      • Page Title: Add Contact
      • Page Slug: add-contact (must be exact, in lowercase and hyphen)
      • In the body of the page, type:  [tdomf_form1]  (with the brackets)
    6. Now let’s make some changes to your WordPress setup:
      • WRITING: Default Post Category: none
      • PRIVACY: I would like to block search engines, but allow normal visitors
      • PERMALINKS:
        • Custom Structure: /people/id-%post_id%
        • Category Base: /list
      • MISCELLANEOUS:
        • Store uploads in this folder: wp-content/uploads
    7. Let’s update the other Plugin options:
      • ADMIN POST LISTING:
        • Hide ‘Title’ column: check
        • In the area under “Custom Fields to Add”, enter:
          • last_name =>
          • first_name =>
      • SEARCH EVERYTHING: Check off what ever options work best for you.

Done!  Your CRM is now ready.


So, how do  you use it?  Here’s a quick tutorial:

  • Adding Contacts: Click the “Add Contacts” button and fill out the form.  When you create a contact a few things happen.  If you add an image to the contact, then the post title becomes the image name.  If you don’t, then the post title becomes the date and time it was created.  You probably didn’t need to know that much, because the post title has been hidden!
  • Adding Companies: Click the “Add Companies” button, and you will be taken to the back-end of WordPress.  Just create a category for every company you want to add.
  • Managing your Contacts: This is also done from the back-end.  But thanks to the ”Custom Admin Post Listing” plugin, when you click MANAGE – POSTS, you won’t see ugly post titles, you’ll see your contacts names.

That’s it!  Enjoy!

Please let me know your thoughts and suggestions, as well as any bugs you find.

59 Responses to “WP-CRM: a basic CRM built with WordPress”

  1. John Says:

    This is so awesome! Can’t wait to install it.

  2. Tim W Says:

    How do I see the vcard data?

  3. sbruner Says:

    You need an hCard/vCard reader to view the data. If you’re using Firefox, download Tails: https://addons.mozilla.org/en-US/firefox/addon/2240

    and then go to any contact page in the theme. An icon at the bottom of your Firefox browser will turn orange. Click on it, and that contacts hCard data will appear. You can also export it to Outlook.

    If you have Tails installed, you can visit the demo site to see it work: http://crmdemo.slipfire.com/people/id-69

  4. Andrew Angus Says:

    Looks great… will this set-up work with WP2.5

  5. sbruner Says:

    The theme will work with 2.5, but I’m not sure about the plugins. I only tested them with 2.3

  6. Mark Says:

    TDO Mini Forms will certainly work in Wordpress 2.5! :)

  7. Bob Says:

    I don’t see how to edit or delete an entry.
    And I needed to hardcode the src for images.
    Otherwise, all is well on my Localhost test installation.
    Thanks for work!

  8. Bob Says:

    I should explain: I am unable to edit a post in order to edit/delete contact information.
    Using WP2.51, when I attempt to edit a post, nothing happens.
    I’m going to install on another server to see whether the problem is server related.

  9. Bob Says:

    If I deactivate the Custom Admin Post Listing plugin, then I am able to edit the posts/contact information.
    This behavior found on both XAMP Localhost and a 1and1.com Linux hosted account, using WP2.51, MySql 5.

  10. Gilles Says:

    Bob,

    You can keep the Custom Admin Post Listing plugin activated *but* you need to uncheck again the “Hide ‘Title’ column?”.

    This way, you can click on the title to edit the post (i.e. the contact).

    Hope this helps!

  11. Awan Says:

    Dear all,

    There’re some basic question since the new version of some plugins have a lot more configuration than before:

    1. How to edit a contact post? I cant find a interface to edit it. even from TDO mini form.
    if i use Manage Post, it will show the profile not the edited form.
    2. The permalink setting : /people/id-%post_id% not working, so i put back into default and it’s work, is it will be a problem?
    3. Which file and part if I wanna to edit the CRM dashboard to choose which data should go infront.

    Many Thanks

  12. sbruner Says:

    Awan,

    TDO mini-forms does not yet allow editing the contacts from the front end. You need to log into the admin to edit.

    To change the data that shows on the main page, edit the home.php file.

    Steve

  13. Matt Says:

    Awesome theme…it was exactly what I needed.

    I am having one little issue.

    I’m getting and error at the top of the ‘add contact’ page (at the top of the form).

    “ERROR: register_globals is enabled in your PHP environment!”

    I’m not much of a programmer, so I don’t even know where to start to fix this.

    Any suggestions would be greatly appreciated.

    Thanks

  14. sbruner Says:

    Matt,

    That’s probably an issue with your host. Contact them and ask them to fix. It’s not an issue with WordPress.

  15. Shaun Says:

    I think I speak for everyone when I say YAHOO! THIS IS AWESOME!! THANK YOU THANK YOU THANK YOU!!!

    P.S. long live open source.

  16. sbruner Says:

    Shaun,

    You are very welcome. Let me know if you have any questions.

    Steve

  17. Matt Says:

    I fixed the error message. I just had to turn off “register_globals” in the php.ini file in the root.

    Thanks again for the killer theme!

  18. Vida Mas Says:

    Steve:

    I have just found out about this CRM plubin and THANK YOU, THANK YOU soo much for this great work. I have just installed it and am delving into this great work now.

    One little thing though. I am using wordpress 2.6 and can’t find the “slug page” section anywhere. Would you have any idea how I can solve this?

    Thank you SO MUCH again.

    Vida

    P.S. Matt, thank you so much for posting the error message re: register_globals as well as the answer. It helped me so much :)

  19. Vida Mas Says:

    Just turned on the email notification. Sorry for the repeat message.

  20. sbruner Says:

    Vida,

    Glad you like the theme!

    In version 2.6 WP calls labels it Permalink on the Page.

    Create the Add Contact page as described above, and press Publish.

    Now go back in and EDIT it. Under the Page title is the Permalink. Click EDIT and make sure it ends in: /add-contact

    Hope that helps.

    Steve

  21. dnnsldr Says:

    Can you use this and set permissions for certain members to see only their contacts? For example, using this with members (salespeople), but only allowing each logged in member to see their own contacts, but for the admin (or supervisors) to view all contacts of all members?
    Thanks,

  22. sbruner Says:

    I am sorry, but currently you cannot limit the posts to only the author in standard WordPress. If you used WordPress MU (multi-user), then each salesperson would essentially have their own individual CRM, and you can manage them all easily.

  23. dnnsldr Says:

    This may be out of the scope for this thread in regards to using WPMU. What I am trying to do is create an intranet portal that salespeople can access to view new info thru post that the WPMU admin would write, a library of documents and have a CRM that they have access to. Only the CRM has to be individual (while admin has full access) but everything else needs to be shared. Using WPMU, I know that I could just install one theme, so everyone has the same theme, but, as the admin, if I write a post, am I able to make sure that every individual member gets that post? I hope this makes sense to someone. Thanks

  24. wael Says:

    looks awesome but fro the demo it miss an option to email the contact directly form inside WP or select more than one contact then send them a message

  25. Justin Says:

    Does anyone know how to port this theme to WP 2.7.1, or at least where I can get the files for WP2.6 for this to work?
    Thanks

  26. Steve Says:

    This theme should work with 2.7. Just make sure you get the most updated plugins.

  27. philipp Says:

    Hi there,

    I actually was about to install it, but now i cant find any download link to the actual theme anymore?! hope its just my mistake or is it currently only open for developers?
    Hope I can get it ^-^
    Cheers

  28. philipp Says:

    ok, sorry, my stupidity ^-^ hope i can get it running nicely on wp 2.7.1! I will report ^-^

  29. philipp Says:

    hurra it works! very very slick! But one question: is it possible to enable “private” entries? I use the theme for a small company and was asked if I can enable the possibility to enter contacts which are only visible for the contributer.
    as far as I can see from the WP backend (2.7.1) its not possible to password protect this entries.
    Please let me know if anyone found a way to do that. I am sadly just a designer not a programmer ^-^
    Help is appreciated!!

    Cheers,

    Philipp

  30. sbruner Says:

    Hi Philip,

    Try this plugin: http://wordpress.org/extend/plugins/members-only/

    Steve

  31. Andy H Says:

    Hi, this is GREAT… have never used WP before and not only was I looking for some basic Blogging… also wanted some basic CRM… seems to work great! However, I do have one problem… after setting up as per the install guide above and publishing a page with the Add Contact form on… I can navigate to it OK but the Link on the Main Page to “Add Contact” seems to remove the site name and then it doesn’t link just comes up with a 404 error… any ideas???

    Regards

    Andy

  32. sbruner Says:

    Andy,

    The “Add Contact” page must have a page slug of “add-contact”. You may want to try updating your permalink structure. If that doesn’t work, please email me your domain address so I can take a look. Use the contact form on this site.

    Steve

  33. John Says:

    unfortunatly this is not working properly anymore on wordpress 2.7.1.

    anybody who can help me set this up? i’m in real need for it.

    also some plugins are outdated and don’t even get activated anymore.

    search everything – does not activate and gives a php on line x error.

    customizable-post-listings – also does not activate under 2.7.1

    anybody who can help me out setting this up?

  34. Daniel Says:

    Hello all,

    I have some trobble with WP 2.7.1 DE

    TDO Mini 0.12.7 dosn’t give me the Tags-Widged also the Category-Widget.

    The only thing I did different to your howto is, I installed the roll-manager 2.2.3

    Is there something new in WP 2.7.1 so we have to chance the howto?

    thanks for Help
    Daniel :-)

  35. John Says:

    @Daniel, the wordpress 2.7.1 does indeed not work entirely with these wordpress crm. i’m also trying to make it work.

    nevertheless some plugins (2 so far) have problems with wordpress 2.7.1 also.

    it would be great if some tech guru came allong and helped us out a bit. because this seriously has greater potential.

  36. sbruner Says:

    John / Daniel,

    What issues are you having with TDO mini-forms? The newest release works well with 2.7.1.

    Steve

  37. John Says:

    @sbruner i’m having difficulties getting all the plugins to work. two of them just give me an php line x and line x and line x error. so they cannot even be activated. and without all the proper plugins working this crm does not fully function as it should.

    hope you have some other sollution

  38. sbruner Says:

    John,

    Unfortunately, we don’t control the plugins. Have you checked the TDO Mini-Forms forum: http://thedeadone.net/forum/

    It’s the best place to get support.

    I am running these plugins on WP 2.7.1 and everything is fine.

  39. John Says:

    anyone who came across the problem with the searcheverything plugin. i’ve managed to get my server switched.

    only searcheverything does not activate as a plugin.

    “Warning: SearchEverything::include() [function.SearchEverything-include]: Unable to access /storage/xxx/wp-content/plugins/./SE-Admin.php in /storage/xxx/wp-content/plugins/search_everything.php on line 38″

    a sollution to my problem would be great.

    ps i have the same issue with line 39 in the plugin code.

  40. Mika Says:

    Is the demo still active? http://crmdemo.slipfire.com comes back with errors:

    Fatal error: Class ‘TDOMF_Widget’ not found in /nfs/c04/h01/mnt/58651/domains/crmdemo.slipfire.com/html/wp-content/plugins/tdo-mini-forms/widgets/tdomf-whoami-widget.php on line 27

19 Trackbacks/Pingbacks

  1. Skylog » Blog Archive » links for 2008-05-13 Says:

    [...] WP-CRM: a basic CRM built with WordPress (tags: wordpress plugin) [...]

  2. 8 maneiras diferentes de usar o wordpress. | WebVicio.com Says:

    [...] adicionar, gerir e pesquisar contactos através do menu de administração. Podemos também usar o WP-CRM um sistema para wordpress para criar un gestor de [...]

  3. XeroBlog - Consejos y Recursos para Bloggers » Blog Archive » 7 Diferentes Formas de usar WordPress Says:

    [...] Manager y GT-CRM plugins demuestran que realmente no hay ninguna limitación de la versatilidad de [...]

  4. 10 zakon Wordpress plugina, treci dio Says:

    [...] WP-CRM – napravite od Wordpressa CRM sustav [...]

  5. WordPress ? 7 ????? | ???? Says:

    [...] ? WP-Contact Manager ? Slipfire ? WP-CRM???? WordPress [...]

  6. Software: TDO Mini Forms Wordpress Plugin (v0.12.2) [ thedeadone.net ] Says:

    [...] TDO Mini Forms has been used to turn Wordpress into a Forum and a Contact Manager! [...]

  7. WP-CRM — Simple Themes Says:

    [...] Release Page [...]

  8. pluginsetc.com » Blog Archive » TDO mini forms Says:

    [...] TDO Mini Forms has been used to turn Wordpress into a Forum and a Contact Manager! [...]

  9. Dale otro uso a tu WordPress - Carrero Bitácora de los Hermanos Carrero, David Carrero Fernández-Baillo y Jaime Carrero Fernández-Baillo. Says:

    [...] WordPress como un CRM básico con WP-CRM. [...]

  10. Otras formas de utilizar WordPress « Helektron.com Says:

    [...] WordPress como un CRM básico con WP-CRM. [...]

  11. Ich bin auch ein Kontakt Manager - Beitrag - Schweizer WordPress Magazin Says:

    [...] vom WP Contact Manager hat SlipFire ebenfalls ein Kontakt Manager Theme erstellt. Das Design von WP-CRM ist zwar giftgrün und nicht sehr ansprechend, aber es bietet sehr interessante Funktionen, die die [...]

  12.   Gaining experience by Communications from DMN Says:

    [...] and even demonstrate your technical skills using a wiki, a blog (some people use WordPress as a CMS), or something like Drupal or [...]

  13. Wordpress Plugin (forms) « Idea Blog Says:

    [...] http://www.slipfire.com/wp-crm-58.htm [...]

  14. Sabahdaily.com » WP TDO Mini Forms Says:

    [...] TDO Mini Forms has been used to turn Wordpress into a Forum and a Contact Manager! [...]

  15. Post Article in wordpress like digg submission | Tech Sathi.com Says:

    [...] TDO Mini Forms has been used to turn Wordpress into a Forum and a Contact Manager! [...]

  16. TDO Mini Forms Plugin | WordPress Plugins Database - WordPressPluginsDatabase.com Says:

    [...] TDO Mini Forms has been used to turn Wordpress into a Forum and a Contact Manager! [...]

  17. 11 Non-Traditional Uses of WordPress Says:

    [...] WP-CRM is another theme for turning WordPress into a contact manager. With WP-CRM you can add contacts and notes from the front end of WordPress without being in the admin dashboard. [...]

  18. IntenseDebate creates the commenting system platform | Red Pill: Shiny New Toy's Blog Says:

    [...] First, the influence of Automattic (who bought IntenseDebate last year) is clear. For years, Automattic has been developing the core WordPress platform with a philosophy of focusing on making the core product excel at what it is supposed to do: help people easily publish content on to the web.  Simultaneously, Automattic has nurtured a plug-in community that encourages the development of add-ons to extend WordPress functionality in ways I’m sure Autommatic never imagined possible.  These plug-ins can convert WordPress from a simple blogging system into robust content management systems, even customer relationship managers. [...]

  19. 7 Different Ways To Use WordPress « webblogkoe.co.cc Says:

    [...] Design Intelliction’s WP-Contact Manager and Slipfire’s WP-CRM plugins prove that there really aren’t any limits to WordPress’s [...]

Leave a Reply