How to use this article:
This article is intended to provide the necessary technical information regarding embedding CERVIS into an existing website by either using an iframe (presented as Option 1 below) or by using direct links to the standalone version of the console (Option 2 is full length URLs, Option 3 is shortened URLs that redirect to the full length URLs). If you would like more information about which page to use or the best pages to embed into your website please submit a ticket to our Customer Support team to schedule a 1 on 1 meeting about Web Integration. The below video provides a quick look at what this process will look like ultimately:
Important Notes Before Going Further:
You must replace 'volunteer.custom-domain-placeholder.org', in the examples below, with your custom mapped domain. If you have not configured custom domain mapping in your account, please refer to the 'Full Custom Domain' section here: https://support.cervistech.com/hc/en-us/articles/360057143492
You must replace 'xxxx', in the examples below, with your 4 digit organization ID. If you are unsure what your 4-digit organization ID is, you can locate it by following the steps below:
- Login to your CERVIS Account.
- Click on the "Edit System Configuration" link under the "System Management" section of the Main Dashboard.
- Locate the the "Organization Information" section of the System configuration which is the first section of the system configuration.
- Locate the "CERVIS Organization ID" field to view your four digit ID.
In some instances you must also replace nnn with another variable depending on the page. If you are unsure how to locate these numbers please contact our Customer Support Team by using the "Submit a Request" feature at the top of the page.
Use one of the following methods to integrate CERVIS into your existing organizational website.
Option #1 - Direct iframe integration:
For Option #1 (Manual HTML iframe page) you can adjust the width of the iframe between 450 and 700 pixels, the height is set by the script.
Looking at the code in the examples below there are 2 major components:
First is the javascript which needs to be included on the page where the iframe is embedded. Where it is included is up to you, but it should be included in such a way that it can communicate with the iframe. This script does 3 main things:
- Resizes the height of the iframe to match the amount of content on the page to prevent interior scroll bars.
- Redirects to the standalone version of the page for small screens like smart phones.
- Enables the use of various variables to simplify the embed process and only require one page on your website to have an iframe. For more information about this and a list of available variables you can review our Website Integration Variables article.
- Opportunity Registration
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/eventwebreglist.php?org_id=xxxx" width="550" height="1075" frameborder="0" title="CERVIS Opportunity Registration"></iframe>
- Opportunity Registration (Calendar View)
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/datewebreglist.php?org_id=xxxx" width="550" height="1075" frameborder="0" title="CERVIS Opportunity Registration"></iframe>
- Opportunity Registration (Filtered for a specific interest category)
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/eventwebreglist.php?org_id=xxxx&event_category_id=nnn" width="550" height="1075" frameborder="0" title="CERVIS Opportunity Registration"></iframe>
- Opportunity Registration (Filtered by a keyword or keywords)
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/eventwebreglist.php?org_id=xxxx&keyword=nnn" width="550" height="1075" frameborder="0" title="CERVIS Opportunity Registration"></iframe>
- Opportunity Registration (Single Opportunity)
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/eventdetail.php?org_id=xxxx&event_id=nnn" width="550" height="1075" frameborder="0" title="CERVIS Opportunity Registration"></iframe>
- Service Project Registration
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/spwebreglist.php?org_id=xxxx" width="550" height="1075" frameborder="0" title="CERVIS Opportunity Registration"></iframe>
- Service Project Registration (Filtered for a specific interest category)
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/spwebreglist.php?org_id=xxxx&event_category_id=nnn" width="550" height="1075" frameborder="0" title="CERVIS Opportunity Registration"></iframe>
- Service Project Registration (Single Project)
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/spdetail.php?org_id=xxxx&event_id=nnn" width="550" height="1075" frameborder="0" title="CERVIS Opportunity Registration"></iframe>
- Volunteer Direct Application
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/webreg/webregaddvol.php?case_switch=2&org_id=xxxx" width="550" height="1075" frameborder="0" title="CERVIS Volunteer Application"></iframe>
- Volunteer Direct QuickReg Application
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/module/quick_reg.php?case_switch=2&console_profile_type=quickapp&org_id=xxxx" width="550" height="1075" frameborder="0" title="CERVIS Volunteer Application"></iframe>
- Project Request Form
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/program/project_request.php?org_id=xxxx" width="550" height="1400" frameborder="0" title="CERVIS Project Request Form"></iframe>
- Group Request Form
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/group/group_request.php?org_id=xxxx" width="450" height="1000" frameborder="0" title="CERVIS Group Request Form"></iframe>
- Administrator Login
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/index.php?org_id=xxxx" width="760" height="850" frameborder="0" title="CERVIS Login"></iframe>
- Special Talents Program #1 (i.e. Home Repair, Tech Team, etc)
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/program/prog_main.php?org_id=xxxx&prog_id=0001" width="550" height="1075" frameborder="0"></iframe>
- Special Talents Program #2 (i.e. Home Repair, Tech Team, etc)
<script type="text/javascript" src="https://cdn.cervistech.com/acts/javascript/resize.js"></script>
<iframe id="myFrame" name="myFrame" src="https://volunteer.custom-domain-placeholder.org/acts/program/prog_main.php?org_id=xxxx&prog_id=0002" width="550" height="1075" frameborder="0"></iframe>
- RSS Feed
https://www.cervistech.com/acts/event_rss_feed.php?org_id=xxxx
Option #2 - Standalone Links:
CERVIS Technologies provides access to a webpage console for those organizations who are not able to or do not desire to integrate CERVIS into their existing website. Below are the links for the External Console.
- Administrator Login
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=login
- Event Registration
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=event&ht=1
- Event Registration (Filtered for a specific interest category)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=event&cat_id=nnn&ht=1
- Event Registration (Calendar View)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=date&ht=1
- Event Registration (Filtered for a specific reservation code)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=event&res_code=nnn&ht=1
- Event Registration (Single Event)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=event_list&event_id=nnn&ht=1
- Volunteer Login
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=check&ht=1
- Mobile Sign-in Login (Often used as a QR Code)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=check&source=reg_view_direct&ht=1
- Service Project Registration
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=sp&ht=1
- Service Project Registration (Filtered for a specific interest category)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=sp&cat_id=nnn&ht=1
- Service Project Registration (Single Project)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=sp_list&event_id=nnn&ht=1
- Volunteer Direct Application
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=application&ht=1
- Volunteer Direct QuickReg Application
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=quickapp&ht=1
- Project Request Form
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=request&ht=1
- Group Request Form
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=group&ht=1
- Special Program #1 (i.e. Home Repair, Tech Team, etc)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=prog_1&ht=1
- Special Program #2 (i.e. Home Repair, Tech Team, etc)
https://www.cervistech.com/acts/console.php?console_id=xxxx&console_type=prog_2&ht=1
Option #3 - Shortened URLs:
Link to External Console with short URLs: Short links to CERVIS pages for use in social media applications
- Administrator Login
https://cerv.is/XXXXl
- Event Registration
https://cerv.is/XXXXe
- Event Registration (Filtered for a specific interest category)
https://cerv.is/XXXXcNNN
- Event Registration (Filtered for a specific reservation code)
https://cerv.is/XXXXrNNN
- Event Registration (Single Event)
https://cerv.is/XXXXdNNN
- Service Project Registration
https://cerv.is/XXXXs
- Service Project Registration (Single Project)
https://cerv.is/XXXXdNNN
- Volunteer Direct Application
https://cerv.is/XXXXa
- Volunteer Direct QuickReg Application
https://cerv.is/XXXXq
- Project Request Form
https://cerv.is/XXXXp
- Group Request Form
https://cerv.is/XXXXu
Comments
0 comments
Article is closed for comments.