Difference between revisions of "Scuttle"

From SME Server
Jump to navigationJump to search
 
(28 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
== Scuttle for SME Server ==
+
{{Warning box|The Scuttle project has abandoned. This how-to no longer applies. Please find an alternative and report back. If you still want to try this how-to, you are on your own including many security risks.}}
 +
== Scuttle ==
 +
{{Level|medium}}
 +
 
 +
{{Warning box|The information on this page was for SME Server 7 only!}}
  
 
=== Maintainer ===
 
=== Maintainer ===
−
[http://www.dungog.net Dungog] (Software)
+
http://www.dungog.net
 +
 
 +
===Version===
 +
 
 +
{{#smeversion: smeserver-scuttle }}
  
 
=== Description ===
 
=== Description ===
−
[http://www.scuttle.org/wiki Scuttle] is a web-based social bookmarks manager that enables you to:  
+
http://scuttle.org
 +
 
 +
Scuttle is a web-based social bookmarks manager that enables you to:  
 
*Store all your favourite links in one place, accessible from anywhere.  
 
*Store all your favourite links in one place, accessible from anywhere.  
 
*Share your bookmarks with everyone, with friends or just keep them private.  
 
*Share your bookmarks with everyone, with friends or just keep them private.  
 
*Tag your bookmarks with as many labels, instead of wrestling with folders.  
 
*Tag your bookmarks with as many labels, instead of wrestling with folders.  
−
<br>
 
−
<br>Step-by-step silly HowTo for installation of Scuttle on a fresh SMEserver 7.1.3.
 
−
<br>Orginates from [http://www.dungog.net/sme/webapp.php#scuttle Dungog HowTo] and some input from the forums.
 
−
<br>It reflects the experiences I've had during install and are probably not always applicable.
 
−
<br>It's intended for Linux-newbies like myself, experienced users are probably better off using the original.
 
−
<br>
 
−
<br>Check latest releases at [http://sme.dungog.net/packages/smeserver/7.0/i386/html/index_dungog.html Dungog SME software]
 
−
<br>
 
  
 
=== Installation ===
 
=== Installation ===
−
This contrib can be found in the [http://www.dungog.net Dungog] repository.
+
This contrib can be found in the [http://mirror.contribs.org/smeserver/releases/7/smecontribs/i386/repodata/index.html smecontribs] repository.  
−
Code
+
 
−
<br>USAGE
+
Download and install scuttle and smeserver-scuttle
−
<br>; My comments
+
yum install --enablerepo=smecontribs smeserver-scuttle
−
<br># "Command to be written or pasted into the console"
+
 
−
<br>
+
No need to reboot.
−
<br>COMMANDS
+
 
−
<br><br>; 1. Log in (with username root) to the SMEserver console.
+
Create database structure
−
<br>
+
/usr/bin/mysql scuttle < /opt/scuttle/tables.sql
−
<br>; 2. If you already enabled Dungog repo, skip down to 6, if your'e unsure, go to 5.
+
 
−
<br>
+
Copy and rename the config file
−
<br>; 3. Add dungog repository to your yum-repositories database:
+
cp /opt/scuttle/config.inc.php.example /opt/scuttle/config.inc.php
−
<br>
+
 
−
<br># /sbin/e-smith/db yum_repositories set dungog repository \
+
Find scuttle mysql password (DbPassword=) with  
−
<br>Name 'SME Server 7 - dungog' \
+
config show scuttle
−
<br>BaseURL 'http://sme.dungog.net/packages/smeserver/7.0/i386/dungog/' \
+
Copy the string, it should be similar to this: 2zvEiYibIewQOsQ07KAtObnh5FcOhUhaq+dtSAdXBjuOBsbSoPt5Bty8PEPfjhfHmL0wejMAmUMO
−
<br>EnableGroups yes \
+
 
−
<br>GPGCheck no \
+
and add the password and edit these line in the config file
−
<br>Visible yes \
+
nano -w /opt/scuttle/config.inc.php
−
<br>status disabled
+
−
<br>
+
$dbtype = 'mysql';             <----------
−
<br>; 4. Do this for the changes to take effect:
+
$dbhost = 'localhost';         <----------
−
<br># /sbin/e-smith/expand-template /etc/yum.conf
+
$dbport = '3306';
−
<br>
+
$dbuser = 'scuttle';           <----------
−
<br>; 5. Check correct input with
+
$dbpass = 'your-new-password'; <----------
−
<br># db yum_repositories show dungog
+
$dbname = 'scuttle';
−
<br>; It should contain the lines in step 3. If you get nothing in return, go back to 3.
+
 
−
<br>
+
Open http://yourserver/scuttle/ and register a user.
−
<br>; 6. Download and install scuttle and smeserver-scuttle
+
 
−
<br># yum install --enablerepo=dungog smeserver-scuttle
+
=== Uninstallation ===
−
<br>; I don't install this from smedev because it may contain an older version.
+
To remove the package from your server issue the following command on the SME Server shell:
−
<br>; You will get a y/n-question, answer y if it looks fine.
+
rpm -e scuttle smeserver-scuttle
−
<br>
+
 
−
<br>Step 7 are not necessary
+
To remove mysql database and user, both are scuttle, see [[MySQL#Remove a database]] and [[MySQL#Remove a user]]. There is no need to reboot.
−
<br>----------------------------------------------------------------------
+
 
−
<br>; 7. WARNING..........:
+
=== Options ===
−
<br># signal-event post-upgrade
+
 
−
<br>; And:
+
* [http://scuttle.org/wiki/firefox_extension Firefox 2 plugin]
−
<br># signal-event reboot
+
* [http://www.kai-mai.com/node/11 Firefox 3 plugin]
−
<br>----------------------------------------------------------------------
+
 
−
<br>
+
* Restrict usage with PublicAccess db, (global-pw are default):
−
<br>; 8. create database structure
+
config setprop scuttle PublicAccess global-pw
−
<br># /usr/bin/mysql scuttle < /opt/scuttle/tables.sql
+
 
−
<br>
+
=== Bugs ===
−
<br>; 9. Copy and rename the config file
+
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-scuttle component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-scuttle|title=this link}}.
−
<br># cp /opt/scuttle/config.inc.php.example /opt/scuttle/config.inc.php
+
 
−
<br>
+
=== Patches ===
−
<br>; 10. Find scuttle mysql password (DbPassword=) with  
+
====htpps====
−
<br># config show scuttle
+
http://sourceforge.net/tracker/?group_id=134378&atid=729862
−
<br>; Copy the string, it should be similar to this:
+
 
−
<br> 2zvEiYibIewQOsQ07KAtObnh5FcOhUhaq+dtSAdXBjuOBsbSoPt5Bty8PEPfjhfHmL0wejMAmUMO
+
a simple one is to allow https usage (https fix)
−
<br>
+
nano -w /opt/scuttle/header.inc.php
−
<br>; 11. Open config file with text editor Pico (^-sign means ctrl-button)
+
−
<br># pico -w /opt/scuttle/config.inc.php
+
-    $root = 'http://'. $_SERVER['HTTP_HOST'] . $root;
−
<br>; Edit the following lines with these values (special for dbpass):
+
+
−
<br> $dbtype = 'mysql';
+
+    $protocol = ($_SERVER["HTTPS"] == 'on') ? 'https://' : 'http://';
−
<br> $dbhost = 'localhost';
+
+    $root = $protocol . $_SERVER['HTTP_HOST'] . $root;
−
<br> $dbport = '3306';
+
 
−
<br> $dbuser = 'scuttle';
+
====404 error====
−
<br> $dbpass = 'paste copied password here';
+
In some cases the following occurs, this change is not usually needed
−
<br> $dbname = 'scuttle';
+
 
−
<br>; Exit Pico, save to file, choose config.inc.php
+
Use 'search all bookmarks' to return at least 3 pages of results.  
−
<br>
+
 
−
<br>; 12. Open http://yourserver/scuttle/ and register a user.
+
Then click the 'Next' button. http://servername/scuttle/search.php/all//?page=2
−
<br>
+
 
−
<br>Step 13-14 are optional, not necessary for Scuttle to function.
+
if you click it again on page 2 and get a 404 error apply the following change
−
<br>--------------------------------------------------------------
+
 
−
<br>; 13. [http://scuttle.org/wiki/firefox_extension Firefox plugin]
+
Fix this by editing /opt/scuttle/templates/bookmarks.tpl.php
−
<br>
+
At line 151, ABOVE this line: (edited to remove html code)
−
<br>; 14. Restrict usage with PublicAccess db, (global-pw are default):
+
 
−
<br># config setprop scuttle PublicAccess global-pw
+
echo class="paging $bfirst .span /span. $bprev .span /
−
<br>; Fore more options: [http://www.dungog.net/sme/webapp.php#scuttle Dungog HowTo]   
+
span. $bnext .span/ span>'. $blast .span> / span.
−
<br>  Scroll to: "to limit access to the web app."
+
sprintf(T_('Page %d of %d'), $page, $totalpages) .'/p';
 +
 +
Add this:
 +
 +
// page url bug on smeserver-scuttle contrib quick fix by MB 2010-12-01
 +
// remove double slashes
 +
$bfirst = str_replace ('//', '/', $bfirst);
 +
$bprev = str_replace ('//', '/', $bprev);
 +
$bnext = str_replace ('//', '/', $bnext);
 +
$blast = str_replace ('//', '/', $blast);
 +
// restore protocol slashes
 +
$bfirst = str_replace (':/', '://', $bfirst);
 +
$bprev = str_replace (':/', '://', $bprev);
 +
  $bnext = str_replace (':/', '://', $bnext);
 +
$blast = str_replace (':/', '://', $blast);
 +
// end of fix
 +
 
 +
 
 +
===Bugs===
 +
Please raise bugs under the SME-Contribs section in [http://bugs.koozali.org/enter_bug.cgi bugzilla]
 +
and select the smeserver-scuttle component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-scuttle|title=this link}}
 +
 
  
−
=== Additional information ===
+
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-scuttle|noresultsmessage="No open bugs found."}}
−
<br>; If you connect to the SMEserver console by Putty ssh-client (or similar) you can copy and paste the commands (very convenient).
+
===Changelog===
−
<br>; Please note that this was written in april 2007, if the software change then this howto may be outdated.
+
Only versions released in smecontrib are listed here.
−
<br>
 
−
<br>Please do edit if you find errors or have improvements, but make sure that it works!
 
−
<br>
 
−
<br>Good luck [http://wiki.contribs.org/User:Per /Per]
 
  
 +
{{#smechangelog: smeserver-scuttle}}
  
−
----
 
  
−
[[Category: Contrib]]
+
 +
[[Category: Deprecated Contrib]]
 +
[[Category: Dungog]]
 +
[[Category: Social Media Apps]]
 +
[[Category: Webapps]]

Latest revision as of 02:28, 18 April 2021

Warning.png Warning:
The Scuttle project has abandoned. This how-to no longer applies. Please find an alternative and report back. If you still want to try this how-to, you are on your own including many security risks.


Scuttle

PythonIcon.png Skill level: medium
The instructions on this page require a basic knowledge of linux.



Warning.png Warning:
The information on this page was for SME Server 7 only!


Maintainer

http://www.dungog.net

Version

smeserver-scuttle
The latest version of smeserver-scuttle is available in the SME repository, click on the version number(s) for more information.


Description

http://scuttle.org

Scuttle is a web-based social bookmarks manager that enables you to:

  • Store all your favourite links in one place, accessible from anywhere.
  • Share your bookmarks with everyone, with friends or just keep them private.
  • Tag your bookmarks with as many labels, instead of wrestling with folders.

Installation

This contrib can be found in the smecontribs repository.

Download and install scuttle and smeserver-scuttle 

yum install --enablerepo=smecontribs smeserver-scuttle

No need to reboot.

Create database structure 

/usr/bin/mysql scuttle < /opt/scuttle/tables.sql

Copy and rename the config file 

cp /opt/scuttle/config.inc.php.example /opt/scuttle/config.inc.php

Find scuttle mysql password (DbPassword=) with 

config show scuttle

Copy the string, it should be similar to this: 2zvEiYibIewQOsQ07KAtObnh5FcOhUhaq+dtSAdXBjuOBsbSoPt5Bty8PEPfjhfHmL0wejMAmUMO

and add the password and edit these line in the config file 

nano -w /opt/scuttle/config.inc.php

$dbtype = 'mysql';             <----------
$dbhost = 'localhost';         <----------
$dbport = '3306';
$dbuser = 'scuttle';           <----------
$dbpass = 'your-new-password'; <----------
$dbname = 'scuttle';

Open http://yourserver/scuttle/ and register a user.

Uninstallation

To remove the package from your server issue the following command on the SME Server shell: 

rpm -e scuttle smeserver-scuttle

To remove mysql database and user, both are scuttle, see MySQL#Remove a database and MySQL#Remove a user. There is no need to reboot.

Options

  • Restrict usage with PublicAccess db, (global-pw are default):
config setprop scuttle PublicAccess global-pw

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-scuttle component or use this link .

Patches

htpps

http://sourceforge.net/tracker/?group_id=134378&atid=729862

a simple one is to allow https usage (https fix) 

nano -w /opt/scuttle/header.inc.php

-    $root = 'http://'. $_SERVER['HTTP_HOST'] . $root;
+
+    $protocol = ($_SERVER["HTTPS"] == 'on') ? 'https://' : 'http://';
+    $root = $protocol . $_SERVER['HTTP_HOST'] . $root;

404 error

In some cases the following occurs, this change is not usually needed

Use 'search all bookmarks' to return at least 3 pages of results.

Then click the 'Next' button. http://servername/scuttle/search.php/all//?page=2

if you click it again on page 2 and get a 404 error apply the following change

Fix this by editing /opt/scuttle/templates/bookmarks.tpl.php At line 151, ABOVE this line: (edited to remove html code) 

echo class="paging $bfirst .span /span. $bprev .span /
span. $bnext .span/ span>'. $blast .span> / span.
sprintf(T_('Page %d of %d'), $page, $totalpages) .'/p';

Add this: 

// page url bug on smeserver-scuttle contrib quick fix by MB 2010-12-01
// remove double slashes
$bfirst = str_replace ('//', '/', $bfirst);
$bprev = str_replace ('//', '/', $bprev);
$bnext = str_replace ('//', '/', $bnext);
$blast = str_replace ('//', '/', $blast);
// restore protocol slashes
$bfirst = str_replace (':/', '://', $bfirst);
$bprev = str_replace (':/', '://', $bprev);
$bnext = str_replace (':/', '://', $bnext);
$blast = str_replace (':/', '://', $blast);
// end of fix


Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-scuttle component or use this link


"No open bugs found."

Changelog

Only versions released in smecontrib are listed here.

Retrieved from "https://wiki.koozali.org/index.php?title=Scuttle&oldid=39799"