officedev / xblock-officemix Goto Github PK

License: MIT License

Python 15.02% CSS 1.60% JavaScript 79.40% HTML 3.98%

xblock-officemix's Introduction

Office Mix XBlock

This XBlock allows for the embedding of lectures hosted on Office Mix directly into an edX course. Students can then view the mixes natively on edX.org.

See it in action by watching this Office Mix XBlock introduction mix.

Installation

To install the Office Mix XBlock within your edX python environment simply run.

$ pip install -r requirements.txt

Enabling in Studio

After installed to enable the Office Mix XBlock within studio navigate to Settings -> Advanced Settings from the top nav bar. Then add "officemix" to the Advanced Module List, as shown in the screen shot below.

Usage

Once enabled in studio, making use of the Office Mix XBlock is an easy process.

Start by navigating to the unit in studio where you want to insert your Office Mix. From here choose the Advanced component.

This will bring up a list of the XBlocks that have been enabled in studio. If you followed the previous step to enable the Office Mix XBlock in studio you will see an Office Mix option. Click on it to insert the Office Mix XBlock into your unit.

After you've inserted the Office Mix XBlock a default Office Mix will be inserted into your unit as shown in the screen shot below.

To change the inserted XBlock click on the Edit button in the upper right corner of the Office Mix XBlock. This will bring up the edit dialog where you can change the display name of the component as well as the Office Mix that is being inserted.

Update the component name to the text you want displayed and then insert the link to the Office Mix you want to embed in your unit.

After you click save your Office Mix XBlock will have been updated with the new values.

At this point simply click on the Publish button and the Office Mix will be available to students to view from within the LMS.

And as with any Office Mix, all of your analytics are available at the Office Mix website.

License

The Office Mix XBlock is released under the MIT license.

Contact Us

For any questions about the Office Mix XBlock or help with using it, feel free to email us at [email protected].

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

xblock-officemix's People

Contributors

Stargazers

Watchers

Forkers

lvnilesh ionisx kurtb edustack petamind edxblocks isabella232 insad-elearning mckinseyacademy

xblock-officemix's Issues

Deprecated?

Is this xblock Deprecated ? Getting this error message: "This mix is not available to watch here. Please try on Office Mix website."

Important information about Office Mix Preview end of service

Important: Office Mix was retired on May 1, 2018. For more help, please read the article below.

https://support.office.com/en-gb/article/important-information-about-office-mix-preview-end-of-service-c1c04f84-a7bb-4602-9645-258017155258?ui=en-US&rs=en-GB&ad=GB

Installation successful but no Officemix in Advanced Menu

Hello all,

I tried installed officemix xblock to OpenEdX following the guide. The installation says it completed successfully. But I don't see officemix option in Advanced menu even after adding it to the advanced modules list.

Here is the log which may be useful -

ubuntu@garuda:/edx/app/edxapp$ sudo su edxapp -s /bin/bash
edxapp@garuda:~$ cd /edx/app/edxapp/
edxapp@garuda:~$ git clone https://github.com/beacloudgenius/xblock-officemix.git
Cloning into 'xblock-officemix'...
remote: Counting objects: 57, done.
remote: Total 57 (delta 0), reused 0 (delta 0), pack-reused 57
Unpacking objects: 100% (57/57), done.
Checking connectivity... done.
edxapp@garuda:~$ cd xblock-officemix/
edxapp@garuda:~/xblock-officemix$ exit
exit
ubuntu@garuda:/edx/app/edxapp$ cd xblock-officemix/
ubuntu@garuda:/edx/app/edxapp/xblock-officemix$ sudo pip install -r requirements.txt
Obtaining file:///edx/app/edxapp/xblock-officemix (from -r requirements.txt (line 3))
  Running setup.py (path:/edx/app/edxapp/xblock-officemix/setup.py) egg_info for package from file:///edx/app/edxapp/xblock-officemix

Requirement already satisfied (use --upgrade to upgrade): requests in /usr/local/lib/python2.7/dist-packages (from -r requirements.txt (line 1))
Requirement already satisfied (use --upgrade to upgrade): XBlock in /usr/local/lib/python2.7/dist-packages (from xblock-officemix==0.1->-r requirements.txt (line 3))
Requirement already satisfied (use --upgrade to upgrade): lxml in /usr/local/lib/python2.7/dist-packages (from XBlock->xblock-officemix==0.1->-r requirements.txt (line 3))
Requirement already satisfied (use --upgrade to upgrade): webob in /usr/local/lib/python2.7/dist-packages (from XBlock->xblock-officemix==0.1->-r requirements.txt (line 3))
Requirement already satisfied (use --upgrade to upgrade): pytz in /usr/local/lib/python2.7/dist-packages (from XBlock->xblock-officemix==0.1->-r requirements.txt (line 3))
Requirement already satisfied (use --upgrade to upgrade): python-dateutil in /usr/local/lib/python2.7/dist-packages (from XBlock->xblock-officemix==0.1->-r requirements.txt (line 3))
Installing collected packages: xblock-officemix
  Running setup.py develop for xblock-officemix

    Creating /usr/local/lib/python2.7/dist-packages/xblock-officemix.egg-link (link to .)
    Removing xblock-officemix 0.1 from easy-install.pth file
    Adding xblock-officemix 0.1 to easy-install.pth file

    Installed /edx/app/edxapp/xblock-officemix
Successfully installed xblock-officemix
Cleaning up...
ubuntu@garuda:/edx/app/edxapp/xblock-officemix$ cd /edx/app/edxapp
ubuntu@garuda:/edx/app/edxapp$ sudo -u edxapp /edx/bin/pip.edxapp install xblock-officemix/
The directory '/home/ubuntu/.cache/pip/log' or its parent directory is not owned by the current user and the debug log has been disabled. Please check the permissions and owner of that directory. If executing pip with sudo, you may want the -H flag.
The directory '/home/ubuntu/.cache/pip/http' or its parent directory is not owned by the current user and the cache has been disabled. Please check the permissions and owner of that directory. If executing pip with sudo, you may want the -H flag.
You are using pip version 6.0.8, however version 8.0.2 is available.
You should consider upgrading via the 'pip install --upgrade pip' command.
The directory '/home/ubuntu/.cache/pip/http' or its parent directory is not owned by the current user and the cache has been disabled. Please check the permissions and owner of that directory. If executing pip with sudo, you may want the -H flag.
Processing ./xblock-officemix
Requirement already satisfied (use --upgrade to upgrade): XBlock in ./venvs/edxapp/src/xblock (from xblock-officemix==0.1)
Requirement already satisfied (use --upgrade to upgrade): lxml in ./venvs/edxapp/lib/python2.7/site-packages (from XBlock->xblock-officemix==0.1)
Requirement already satisfied (use --upgrade to upgrade): markupsafe in ./venvs/edxapp/lib/python2.7/site-packages (from XBlock->xblock-officemix==0.1)
Requirement already satisfied (use --upgrade to upgrade): python-dateutil in ./venvs/edxapp/lib/python2.7/site-packages (from XBlock->xblock-officemix==0.1)
Requirement already satisfied (use --upgrade to upgrade): pytz in ./venvs/edxapp/lib/python2.7/site-packages (from XBlock->xblock-officemix==0.1)
Requirement already satisfied (use --upgrade to upgrade): webob in ./venvs/edxapp/lib/python2.7/site-packages (from XBlock->xblock-officemix==0.1)
Requirement already satisfied (use --upgrade to upgrade): six in ./venvs/edxapp/lib/python2.7/site-packages (from python-dateutil->XBlock->xblock-officemix==0.1)
Installing collected packages: xblock-officemix
  Running setup.py install for xblock-officemix
Successfully installed xblock-officemix-0.1

Any help is appreciated.

Thanks,

Installation issue

I setup edX in vagrant virtualbox using production setup instructions from edX git repo then I cloned this repo

vagrant ssh
cd ~
git clone https://github.com/OfficeDev/xblock-officemix.git
cd xblock-officemix
pip install -r requirements.txt

failed so I tried

sudo pip install -r requirements.txt

Then I enabled in studio as described at
https://github.com/OfficeDev/xblock-officemix/blob/master/README.md#enabling-in-studio

However, I do not see OfficeMix when I select advanced as described https://github.com/OfficeDev/xblock-officemix/blob/master/README.md#usage

Q1. What am I missing?
Q2. Is ~/ the correct location to clone?
Q3. Is the master correct brand to pull from? I do not see any release or stable marking or others tags in the git repo yet.
Q4. Is virtualenv usage expected? This vagrantbox with edx gets deployed with virtualenv already but your documentation is silent so I was not sure. If so, how do I set up so that officemix can be deployed correctly in the edX?

iframe element does not include title attribute

I reviewed this XBlock in my devstack and noticed that there is no title attribute on the <iframe /> element. The title attribute serves as the accessible label for an <iframe /> which gets presented to screen reader users when they navigate to the embed or when they list embedded elements or other navigable blocks/region on a page. I think it would be sufficient to use the "Component Display Name" as the value of the title attribute for this XBlock. It would also be helpful to reference this in the help text for "Component Display Name" i.e.
"The name students see. This name appears in the course ribbon, as the accessible label, and as a header for the video."

More info:

Xblock crashing intermittently

We have found several instances in Open Edx when the xblock failed to play the video and crashed instead. Can you suggest what might be the reason? It is working fine on the same browser in other machines but crashed on others' machines. This is happened atleast 5-6 times in the past few weeks. Thanks. Please find the screenshot attached.