| Info | ||
|---|---|---|
| ||
The My VT uPortal Quick Start was released to the uPortal community in 2006 in response to all the positive attention we received for our own portal work at the time. It was never officially supported by Virginia Tech and was merely offered as a proof-of-concept to show how one could push the boundaries of uPortal. Future plans for My VT are to move to DLM with a much simpler UI that is lightweight, clean, and easy to support. |
Virginia Tech is pleased to offer a uPortal 2.4.2 Quick Start with most of our My VT modifications applied. For a preview/summary of our changes, take a look at our online tour.
...
...
Please put comments at the end of this document if things are unclear/incomplete/incorrect and I will update the documentation. I'm just trying to get this out the door, so the document will evolve over time.
What's in the Quick Start
...
- My VT look and feel in "khaki" and "grey"
- My VT customization interface which is a simplified Integraded Modes
- Updated Content Subscriber channel
- Search and browse in one screen
- Keywords support for channel
- Word stemming and case-insensitivity for searches (uPortal 2.5 has case-insensitivity)
- Sample CNET News.com channel XML profile
- Sample fragments with example subtabs
- navigate.jsp to allow navigation among tabs/pages
- My VT frame for pulling in external content
- Debugging XML output to logging enabled by default
Getting the Quick Start Running
- Download uportal-2-4-2-myvt-quick-start.zip
- Unzip the file
- Go to the uportal-2-4-2-myvt-quick-start directory
- At the command line, run:
ant hsql & - Then run:
ant tomcatstart & - Access the portal at http://localhost:8080/uPortal/
...
This script will do the following:
- Stop tomcat
- Deploy any code/XSLT changes you've made
- Reset the uPortal database using data.xml
- Publish a sample channel profile provided
- Publish the sample fragments
- Start tomcat
...
- Log on with demo/demo
- Click the Change Content button
- Create a new tab
- Rename the tab to: tab::Chicken
- Click the Add Default Page link
- Click the Add Main Column link
- Click the Add Side Column button
- Rename the tab to: tab::Home*
- Click the Finished Changing Content button
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<?xml version="1.0" encoding="UTF-8"?>
<layout userName="" newNodeID="6" ID="userLayoutRootNode" mode="edit"
page="default" tab="5" authenticated="true">
<tab name="Administration" ID="3" locked="yes" type="system">
<tab name="Channel Manager" ID="14-2" locked="yes" type="system">
<page name="default" ID="14-3" locked="yes" type="system">
<column name="main-column" ID="14-4" locked="yes" type="system">
<channel .../>
</column>
</page>
</tab>
<page name="default" ID="14-14" locked="yes" type="system">
<column name="main-column" ID="14-15" locked="yes" type="system"/>
</page>
</tab>
<column name="footer" ID="4" locked="yes" type="system">
<channel .../>
</column>
</layout>
|
| Anchor | ||||
|---|---|---|---|---|
|
Navigating Tabs and Pages
...
To return to normal view from full screen channel view:
/uPortal/navigate.jsp?root=root
Additional Colors
Someone noticed that the My VT quick start came packaged with only grey and khaki colors yet it referenced many others in the CSS file. The attached additional colors zip file provides the other colors used by My VT at Virginia Tech. Just unpack the files to the same location of your grey and khaki folders (typically <myvt-quick-start_dist>/uPortal_rel-2-4-2/webpages/media/edu/vt/portal/layout/TabPageColumn/InlineCustomization/images/). Please note that this zip archive also contains the original grey and khaki files so it will probably try to overwrite.
Using the Frame
The frame.jsp loads external content in an iframe that looks similar to the full screen channel mode. Used parameters are:
...
Publishing a Channel
At the command line, run: ant pubchan -Dchannel=<Channel Filename>
Example: ant pubchan -Dchannel=cnet-news-com.xml Publishing Fragments
At the command line, run: ant pubfragments -DfragmentFile=<Path to Fragments File from uPortal root>
Example: ant pubfragments -DfragmentFile=/properties/al/fragment.xml Adding a User
At the command line, run: ant md5passwd -Dusername=<Username>
Example: ant md5passwd -Dusername=bcjones
Known Bugs
- Images for folders and channels in the Content Subscriber channel do not work. The image files are licensed by VT and cannot be distributed, I have not yet updated the XSLT to point to generic versions.
- The uPortal 2.4.2 XHTML output sometimes puts a random > into the output. This is not a problem with the My VT mods, but a problem with out of the box uPortal.