Omeka

Installing Omeka

Omeka is an open-source web application that can be used to create and display online digital collections. Developed by programmers at George Mason University, Omeka was designed to be user-friendly, both during installation and setup and during daily usage. To install Omeka, use these simple steps:

  1. To get started you’ll need to login to your control panel (https://domains.skidmore.edu/dashboard) using your Skidmore username and password.

  1. Once logged in you’ll be at the homepage of your control panel. Navigate to the Web Applications section of the cPanel and find Featured Applications. Then select Omeka.
  2. This page gives you more information about the Omeka software. To begin the install click install this application in the upper-righthand corner. 
  3. On the next page the installer will ask for some information about this install. The first thing you’ll want to do is decide where to install it. If you’re wanting to install Omeka on your main domain, you can leave the directory area empty. If you created a subdomain, you can select it from the dropdown menu. You also have the option of installing Omeka in a subfolder by typing in the folder name in the Directory field. Click here for more information about subdomains and subfolders.

  1. By default the installer will automatically backup your website and update it anytime a new version comes out. While we recommend you keep this option, it is possible to only do minor updates, or turn them off completely. The installer will also create a database for you automatically, but if you’ve already created one for this website you can choose Let me manage the database settings and enter the details. Click Install to continue. 
  2. The installer will take just a few moments to install Omeka and a progress bar will keep you updated. When it is complete you will see a link to your new Omeka site as well as a link to the backend administrative section for your Omeka site. Click the website link to configure your new Omeka installation. 
  3. When you visit your new Omeka installation for the first time, you will be taken to the site configuration page. Enter a UsernamePassword, and Email for the administrative superuser (i.e. yourself).
    9422087925_cf7c86c725_o
  4. Under “Site Settings,” enter an Administrator Email and a Site Title. The Administrator email is the address that messages from the system (e.g. forgot password email reminder) will appear to come from. You might want to create a custom email address using these instructions, for example webmaster@yourdomain.com or omeka-admin@yourdomain.com, to use for this purpose. The Site Title will appear at the top of your visitors’ browser windows.
    9422087901_f1349b92bc_o
  5. Further down the Site Settings page are several numerical settings; you may leave these at the defaults if you are new to Omeka. When you are done making changes, click the Install button to submit the configuration page and proceed.
    9422087885_d63b931583_b
  6. Congratulations! Omeka is now installed. Use the buttons to either proceed to the Public Site, or to begin adding content, go to the Admin Dashboard.
    9422087847_242d03b60f_o

Installing Plugins

There are a variety of plugins that enable additional functionality in Omeka, but in order to easily add them you will first need to install Escher, a plugin installer. All the plugins available for Omeka and their descriptions can be found on this page.

1. Find the Escher plugin listing and click the red button on the right to download the Escher zip file.

omeka-plugins

2. Next, open up your cPanel Dashboard and click on the File Manager. You can find the File Manager under ‘Files’ or by typing “File Manager” in the upper right search bar.

 

3. Go to the public_html > omeka > plugins folder by clicking on the folder icons in the file menu, or by typing “public_html/omeka/plugins” into the navigation bar at the top and clicking ‘Go’.

file-mngr

4. Next you will need to upload the Escher zip file you downloaded into the plugins folder. Select the Upload option in the top menu to open up a new tab where you can upload the zip file. When the upload is complete, click the ‘Go back to home/yourdomain/public_html/omeka/plugins’ link at the bottom of the page to return to the File Manager. You will see that the Escher zip file has appeared in the plugins folder.

extract

5. Make sure the Escher zip file is selected (it should be highlighted in blue), then click Extract from the menu at the top of the page. A small window will open up to confirm where the file will be extracted to. If you were in the plugins folder, it should say public_html/omeka/plugins, if not, type that into the box before you hit Extract File(s).

extract2

6. Another window will open that outlines the contents of the file. Just hit the Close button and the installation will be complete.

extract3

 7. The Escher plugin should now be available in the plugins tab in your Omeka.

escher1

8. To use Escher to install other plugins, click on Escher in the left hand sidebar.

escher-2

9. Next, select the plugin you’d like to install from the dropdown menu and click the Upload button. The plugin will be installed and appear in the plugins page, which you can access from the menu at the top of the page. You will then have to turn on the installed plugin by hitting the Activate button.

escher-3

Using Omeka

You can learn how to use this application in the official Omeka Support Documentation. This support guide will help you get started and begin creating your Omeka site.

Migrating from SITES dot

If you’ve built a great website on Skidmore Domains but want to customize it beyond the available options, you can transfer it to Skidmore Domains. Using your own domain on Skidmore Domains gives you full creative control over your site’s appearance and the flexibility to add new functionality. In addition, Skidmore Domains domains are hosted through Reclaim Hosting, which provides a convenient migration service so you can keep your site after you leave.

Caution: All the content and media contained within your posts and pages can be migrated, but files in your Media Library, your theme, and any appearance settings will not transfer to your new WordPress site. You will have to set these up again once you migrate your content.

Export Your Site

Go to your cPanel and sign in to your account. Go to My Sites and click on the dashboard of the site you want to migrate.

Click on Tools > Export in the toolbar to the left. Select what you want to transfer, then download the export file.export.001

Install WordPress on your Skidmore Domains domain and go to your WordPress dashboard. You may want to delete the automatically generated example posts and pages (e.g. the “Hello world!” post).deleteposts.001

Import Your Site

In your Skidmore Domains WordPress dashboard, go to Tools > Import in the toolbar on the left. Choose WordPress from the list of systems.import.001

Click on Choose File and select the file you exported from SITES dot. Then upload the file and import it.import2.001

You will be asked to assign authors to the posts or pages you import. You can choose to keep and display the authors’ names from the SITES dot version of your content or change them to something else. Remember to update the passwords and roles of imported users once the migration is completed. If you want to keep the file attachments (image, video, document, etc. files uploaded into your posts from the post edit screen), be sure to check the import attachments box before you click Submit.authors.001

author2.001

Congratulations! The migration is complete and you can start customizing your new site on Skidmore Domains

What Can You Do with Your Skidmore Domains Account?

Your ability to do things on Skidmore Domains is dictated to a large degree by the limits of your imagination. That said, there are some technical requirements and limitations that you should be aware of and might want to review.

To spark your imagination, here are some ideas that might help you get started:

Install a Web Application in Your Space

domains.skidmore.edu makes it very simple to install certain Web applications in your Web space. Web applications are just special software that run on a Web server. Usually they allow you to build and manage a Web site. The kind of site you can build depends upon the type of application you install. Here are some examples of applications that you can easily install within the domains.skidmore.edu Web hosting interface:

WordPress LogoWordPress: WordPress is a blogging application. While it allows you to quickly and easily set up a blog, it also comes with a set of features that really make it possible to set up any kind of basic Web site without much difficulty. We have resources available that are focused on installing and using WordPress.

Mediawiki LogoMediawiki: If you’ve ever browsed or edited Wikipedia, you’ve already used Mediawiki. It is the open-source wiki software that runs the online encyclopedia, and you can install it on your Web space. It’s a good choice if you’re interested in publishing documents and then collaborating with others on them. We have instructions for installing Mediawiki.

ZenPhoto iconZenPhoto: This application is a good choice if you’re looking for a way to share images in your Web space. It’s also a quick install through Installatron in cPanel onto your domains.skidmore.edu Web space.

OwnCloud iconOwnCloud: If you’ve used DropBox, the concept of OwnCloud will be familiar. It allows you to upload and access files from anywhere with Web access. You can also share those files and sync them to your devices. This Web application is another quick install through Installatron in cPanel.

These are just a FEW of the open-source applications that are available to you in your domains.skidmore.edu Web space; you can find a list of all of the applications you can install automatically here.  We encourage you to read more about what Web applications are and which ones are available to you through this project.

Organize Your Site with Subdomains and Folders

Through this project, you’ve received a domain name that you can actually subdivide and organize anyway you like. One easy way to organize your domain is to create subdomains, in which you can then install other applications. In addition, you can just set up subfolders for your site (which can also have their own applications installed in them). Here’s an example of how you might organize your site (using the subdomain vs. the subfolder approach)

Subdomain Approach Subfolder Approach
yourdomain.com (“root”) Install WordPress as your “main site” yourdomain.com (“root”)
course1.yourdomain.com Install a second WordPress instance for a course you’re taking yourdomain.com/course1
photos.yourdomain.com Install ZenPhoto for a public photo gallery of your photos yourdomain.com/photos
docs.yourdomain.com Install MediaWiki for a club you belong to that wants to collaboratively edit its bylaws yourdomain.com/docs
files.yourdomain.com Install OwnCloud so you can access your files on your laptop and at work yourdomain.com/files

This is just an EXAMPLE of a way to organize your site and then use different sections to do different things. There is no one solution to this challenge, and what you do should be driven by what makes sense to you. To start, you may just want to install one thing at the “root” of your domain, and then let the rest evolve as you get to know more about what’s possible.

Map Your Domain (or a Subdomain)

If you already have a digital presence that you’d like to pull into your domains.skidmore.edu space, domain mapping is an option you may wish to explore. This allows you to assign your domain (or a subdomain) to another service. Some services that work with domain mapping are:

When you map a domain, users who visit your URL will automatically see your space on one of these services. It’s a great way to incorporate your activity elsewhere into your domain, and it might be a good first-step if you’ve already established a presence somewhere else and just want to point your new domain to that space.

Map Your Domain to Blogger

Mapping your domain is an important part of domains.skidmore.edu; it reinforces the idea that you don’t necessary need to host all your own applications. You should, however, be mindful of making your web presences part of a domain you control. If you would like to map a subdomain and have not yet created it, use this tutorial on creating subdomains before proceeding. To map your domain, or a subdomain, to Blogger, use these steps:

  1. To get started you’ll need to login to your control panel by going to the domains.skidmore.edu homepage and logging in.

  1. Here you’ll login with you Skidmore username and password.

  1. Once logged in you’ll be at the homepage of your control panel. The easiest way to navigate the panel is using the search feature in the top right panel. Click the Search box and type “DNS” (without the quotes). Click on Advanced Zone Editor and you will automatically be directed to the DNS Advanced Zone Editor page. Or, you can scroll down and click on the DNS Advanced Zone Editor button on the cPanel.
  2. Find the domain, or subdomain, you want to map to Blogger in the list of Zone File Records. Under the Action column, click Edit
  3. Leave the Name, and TTL fields set to their defaults. Update the Type drop-down menu to CNAME, and the Address field to ghs.google.com. Click Edit Record when you are done. Keep this window open; you will need it in later steps. 
  4. In a new window, go to the Blogger website, and login with your Blogger/Google username and password. blogger sign in.001
  5. From your Blogger Dashboard, find the blog you’d like to use, expand the More Options menu, and click Settings.
  6. On the “Basic Settings” page, find the Publishing section, and click the Setup a 3rd party URL for your blog link.
  7. Under Advanced Settings, type the full subdomain or domain you are mapping into the box, leave the Use missing files host? option set to No, then click Save.
  8. You will be presented with a message that your domain cannot be verified, along with information about your existing DNS entry, and an additional DNS entry that needs to be made. This is normal. Copy the second entry under the Name, Label, or Host entry to your clipboard.
  9. Go back to the window or tab containing the Advanced DNS Zone Editor in your create.ou.edu cPanel. In the Add a Record section, paste the text you just copied into the Name field. This information will be different for each domain. Set the TTL field to 14400, and the Type drop-down menu to CNAME
  10. Go back to the window or tab containing the Blogger Advanced settings panel, and copy the second entry under the Destination, Target, or Points to column to your clipboard.
  11. Go back to the window or tab containing the Advanced DNS Zone Editor in your create.ou.edu cPanel. In the Zone File Records section, find the domain you were editing Action for and paste the text you just copied into the CNAME field. This information will be different for each domain. Click Edit record when you are done. 
  12. Return to the window or tab containing the Blogger Advanced settings panel, and click Save.
  13. If everything was successful, your domain will now appear as the Blog Address. Keep in mind that it may take up to 72 hours for your domain or subdomain to correctly point all visitors to the correct location.

Choosing your domain name

Choosing your domain name is the first step in getting started with staking your claim on the web. Your domain name is really just a unique Web address that can be used to build out your own digital presence. As you make your choice, there are a few considerations to keep in mind:

Your Domain Name Must Be Available: Domain names must be unique, which means in order for you to claim your own, you need to be sure that it is currently available (and not being used by any one else or any company or organization). There are lots of tools to check on domain availability, and when you sign up on domains.skidmore.edu, we’ll actually check the availability of your choice for you. If you’d like to spend some time thinking about your choice and checking availability before you actually sign-up, we recommend using whois.net.

You Must Choose a “Top Level Domain” or TLD: The TLD is the suffix (or ending part) of your domain name. On domains.skidmore.edu, we only allow you to choose from 5 TLDs: .com, .net, .org., .info. and .us. You must choose which one you want to use (and the availability of your domain may depend upon the TLD you choose). Historically, .com domains were meant for businesses and commercial entities. On the other hand, .org domains were usually used by non-profit organizations. The .net domain was mean to be used by internet service providers. All of that said, the “historic” uses of these TLDs means very little anymore. You may find that .com domains are easier for people to remember, or you may like the “non-commercial” message of using a .org. The bottom line is that your choice of a TLD is entirely personal: just make sure that you choose one of the TLDs allowed by domains.skidmore.edu.

Choose a Domain You Can Live With: You should choose a domain name that you feel you can live with for quite some time. You should pick something that you won’t find embarrassing in the future. A good rule of thumb is to pick a domain that you would be comfortable putting on a future job application.

You May Wish to Include Your Name in Your Domain: There is no requirement that your domain reflect your specific identity in the form of your first and last name. However, choosing a domain name that includes your name may make it easier for you to achieve higher rankings in search engines when someone queries your real name.

Pick a Domain you Like: At the end of the day, your domain should reflect you. Pick a domain you like and are proud of. It can reflect your interests, sports you play, or your hobby. Or it could just be your name. The “right” domain for you is the one you’re comfortable with.

What Exactly is a Web Application?

In the most general terms, a Web application is a piece of software that runs on a Web server. A Web server is a just a specialized computer designed to host Web pages.

Most Web applications are comprised of two components: files and a database. When you install a Web application, you will need to make sure all of the files are copied over into the appropriate location AND that a database (and database user) has been set up to connect to those files. Often, you will have to do some configuration to make sure the application knows how to access the database.

The system we use for domains.skidmore.edu uses a special script installer called Installatron (in cPanel) that allows you to automatically install dozens of open source applications. When you use Installatron, you don’t need to worry about moving files, creating databases, or doing the initial configuration. It’s all taken care of for you. You can find out more about Installatron here.

In order to run on the domains.skidmore.edu server, Web applications must be able to run on a LAMP server, which is the particular kind of Web server that we use. Occasionally, a Web application may require additional components or modules that need to be installed on the server.

Subdomains vs. Subdirectories

When you’re first getting started with a new space on a new Web host, you might think of yourself as owning a small “territory” of the Web. Everything you place in your public folder on the server becomes available for anyone on the Web to see (assuming they know the address of your site and the files you’ve placed there).

If you’re just putting up a handful of static, HTML pages which you want to make available to colleagues, friends, or family by sending them links, then working with this large, unorganized space may work. But as soon as you get to the point where you want to organize your site, you’re going to need a new strategy.

Consider this scenario: you want to have a personal blog on your new Web space, where you share pictures and short written pieces with family, friends, and colleagues. In addition, you’re working on a large research project that requires you to build a Web-based repository of digital images related to your discipline. You want to use one application (say, WordPress) to manage your personal blog. For your research project, you’ve settled on another open-source application (Say, Omeka). Both of these are applications that need to be installed on your Web host, but you can’t just put them both at your main domain name – if you did, both sites would quickly experience conflicts and errors. You need to cordon off separate spaces for your different Web “properties.”

There are two primary strategies for parceling up your Web space. You can create subdomains or subdirectories. But before you can understand the difference, you need to first understand what we mean when we talk about your root domain.

Root Domain

Let’s say you’ve registered a new domain for domains.skidmore.edu called yourdomain.com. Anything that is stored at this core URL is considered to be at the root of your domain: Nothing comes before the address or after the address. You can certainly decide that you simply want to have a single site on your Web host (say a blog running WordPress), and you can set that blog up at your domain’s root. To get to your site in this scenario, users would simply go to yourdomain.com.

Subdomains

When you want to do more than just have a single site at the root of your site, you need to decide now to organize your space. One way to do so is by setting up subdomains.

You’re already familiar with the concept of subdomains, even if you don’t know it. Consider OU’s public Web site at http://ou.edu. As you browse parts of that site, you’ll notice that the domain changes. When you’re looking at your department Web site, say the site for the Chemistry & Biochemistry Department at http://chem.ou.edu, the URL is no longer just ou.edu. Now the root of the url is chem.ou.edu, indicating that you’re on the part of the site that is dedicated to the Chemistry & Biochemistry Department.

If you browse to the technology store pages at http://itstore.ou.edu, you’ll notice that the domain changes again, this time indicating that you’re in the technology store of the OU site.

As you can see the domains serve two purposes: they help to organize the site from a technical perspective, but they also serve as indications to the users that they are in a new/different space.

As you work on your site, you’re welcome to create as many subdomains as you like, and in each subdomain you can actually create a distinct, individual Web site.

Subdirectories

The alternative for organizing your space is to simply set up subdirectories. These function much like file folders on your computer. Instead of creating a blog at blog.yourdomain.com you would place it in a subdirectory called “blog” making the address yourdomain.com/blog. Setting up subdirectory is really easy. You can create folders on the fly when installing applications (like WordPress), and you can also manually create them in your file browser.

There is one particular issue you need to be aware of. Let’s say you’ve installed WordPress to be your primary blog at yourdomain.com. Later, you decide you want to create another image gallery site on your site, and you want to place it at yourdomain.com/gallery. But, if for some reason you’ve already created a page on your WordPress site called “Gallery” then the url yourdomain.com/gallery will already be taken. If you try to create a subdirectory of the same name, you’ll get a conflict and errors.

Tips & Review
  • Subdomains are generally a cleaner, more elegant solution to organizing your site. You’re less likely to get conflicts or errors. However, when using subdomains the process is slightly more complicated: You must create subdomains first, before you can install anything in them.
  • Subdirectories don’t create as pretty URLs as subdomains, but they’re easier to set up. They can, however, result in conflicts with existing Web pages.
  • As soon as you create subdomains or subdirectories to organize your site, you need to consider how people are going to find them. If you’ve created a new primary blog at blog.yourdomain.com, and someone goes to just yourdomain.com, they won’t see that new site. It is possible to set up redirects to avoid this issue. You can also always create links from pages on one subdomain of your site to another.
  • If you really just need one site, sometimes installing at the root of your domain is the easiest thing to do, at least as you’re getting started. You can always add more pieces to your territory later with either subdomains or subdirectories.
Tutorials

What is DNS?

Remember back before everyone had computers that fit in their pocket, how companies would ship a book full of phone numbers to your doorstep? We might have known who we were looking for, but we needed to look up phone numbers unless they were your crazy relatives that you learned to memorize. When you get your own domain name, by default it’s nothing more than a shortcut, an address, or (to fit this very imperfect analogy) a phone number. When you type a domain name into the address bar of your browser, someone has to identify it and tell it what to display. That’s where a name server comes in.

A name server is a computer, running as a server, that keeps a record of all the domain names that are associated with it and keeps track of where those domains should go. In the case of domains.skidmore.edu the name server is the same computer that runs the hosting. You can peek behind the hood and see this in action by going to the 'Websites and Domains' tab of your panel account and clicking on 'DNS Settings'. You see, DNS stands for Domain Name System and the name server on domains.skidmore.edu gives control to it to identify what should be displayed when someone types in your domain. Consider the fact that you might have one or more subdomains in your account. The name server and DNS are able to identify those subdomains and let the world wide web know that they exist and point to some files/folders on a computer somewhere.

When you signed up for a domain through the domains.skidmore.edu system your name servers were chosen for you. So when people type in your address, the server responds with information about your account. When you migrate an account away from one hosting platform like domains.skidmore.edu and onto a new service, it will require you to change the name servers so that your domain name points to a new server with its own files and structure. It’s also possible to have subdomains that point to entirely different servers than domains.skidmore.edu. For example, you could have a subdomain that looks to Tumblr for files.

What is a subdomain?

A subdomain is one way of organizing and separating content on your site. You’re already familiar with the concept of subdomains, even if you don’t know it. Consider OU’s public Web site at http://ou.edu.

As you browse parts of that site, you’ll notice that the domain changes. When you’re looking at your department Web site, say the site for the Chemistry & Biochemistry Department at http://chem.ou.edu, the URL is no longer just ou.edu. Now the root of the url is chem.ou.edu, indicating that you’re on the part of the site that is dedicated to the Chemistry & Biochemistry Department.

If you browse to the technology store pages at http://itstore.ou.edu, you’ll notice that the domain changes again, this time indicating that you’re in the technology store of the OU site.

As you can see the domains serve two purposes: they help to organize the site from a technical perspective, but they also serve as indications to the users that they are in a new/different space. As you work on your site, you’re welcome to create as many subdomains as you like, and in each subdomain you can actually create a distinct, individual Web site.

Additionally, we have resources that demonstrate setting up subdomains and illustrate the difference between subdomains and subdirectories.

Video Tutorial & Ideas

E-commerce Applications

Skidmore Domains’s Installatron offers 9 e-commerce applications. However, members of the Skidmore College and Skidmore Institute of International Studies community are not allowed to utilize these applications to actually conduct sales or make money.

In Skidmore’s Web Policies under ‘Guidelines for All Web Pages’, section 1b, it states:

Unauthorized use of Skidmore College’s Web sites for commercial purposes is prohibited. Personal or institutional Web pages may not be used for direct advertising for personal profit or gain.

Under section 1d of the ‘Guidelines for Student Organization Sites, Personal Pages and Postings’, it further states that:

The College will review complaints, questions, and concerns regarding allegations of copyright infringement, misuse of intellectual property, harassment, use of College Web resources for commercial purposes, and other legal issues. If the complaint is valid, the College will contact the student organization’s Web editor and request immediate revision of the Web page and/or removal of inappropriate materials in compliance with College policies, intellectual property law, and guidelines for responsible use of computing resources. The College may shut down the Web site if there is inadequate or no response from the student organization. Illegal, irresponsible, or unethical activities may result in loss of privileges or penalties consistent with the judicial procedures and policies of the College.
E-commerce applications remain available in the Installatron solely for educational purposes, so that students, faculty, and staff can explore them in order to expand their knowledge of digital tools. Please feel free to install and experiment with them on your domain, but be aware that inappropriate usage could lead to a request to desist or result in your site being shut down.