25 |
26 |
29 |
--------------------------------------------------------------------------------
/doc/developers/running-unit-tests.rst:
--------------------------------------------------------------------------------
1 | Running unit tests
2 | ==================
3 | The tests are dependent on the pear packages HTTP_Request2 and Stream_Var.
4 |
5 | Install them with: ::
6 | $ pear install HTTP_Request2
7 | $ pear install Stream_Var
8 |
9 | Go to the SemanticScuttle ``tests`` directory and run ``phpunit``::
10 |
11 | $ cd tests
12 | $ phpunit .
13 |
14 | also remember the ``--verbose`` parameter to PHPUnit.
15 |
16 | If you want to run a specific test class only: ::
17 |
18 | $ cd tests
19 | $ phpunit BookmarksTest.php
20 |
21 | If you need to test one method only: ::
22 |
23 | $ cd tests
24 | $ phpunit --filter BookmarkTest::testUnificationOfBookmarks tests/BookmarkTest.php
25 |
26 |
27 | Caveats
28 | -------
29 | Having debugging enabled and database driver "``mysql4``" activated
30 | will lead to failing tests because of ``FOUND_ROWS()`` usage, which
31 | does not work nicely with database debugging.
32 |
--------------------------------------------------------------------------------
/data/templates/default/tags.tpl.php:
--------------------------------------------------------------------------------
1 | includeTemplate($GLOBALS['top_include']);
3 | ?>
4 |
5 | 0) {
7 | ?>
8 |
9 |
PHP-gettext provides a simple gettext replacement that works independently from the system's gettext abilities.
10 | It can read MO files and use them for translating strings.
11 |
This version has the ability to cache all strings and translations to speed up the string lookup.
12 | While the cache is enabled by default, it can be switched off with the second parameter in the constructor (e.g. when using very large MO files
13 | that you don't want to keep in memory)
36 |
37 |
40 |
--------------------------------------------------------------------------------
/www/go.php:
--------------------------------------------------------------------------------
1 |
15 | * @license GPL http://www.gnu.org/licenses/gpl.html
16 | * @link http://sourceforge.net/projects/semanticscuttle
17 | */
18 | $httpContentType = false;
19 | require_once 'www-header.php';
20 |
21 | if (!$GLOBALS['shorturl']) {
22 | header('HTTP/1.0 500 Internal Server Error');
23 | header('Content-Type: text/plain');
24 | echo 'Short URL service deactivated';
25 | exit();
26 | }
27 |
28 | if (!isset($_SERVER['PATH_INFO'])) {
29 | header('HTTP/1.0 400 Bad Request');
30 | header('Content-Type: text/plain');
31 | echo 'Short URL name missing';
32 | exit();
33 | }
34 |
35 | list($url, $short) = explode('/', $_SERVER['PATH_INFO']);
36 |
37 | $bs = SemanticScuttle_Service_Factory::get('Bookmark');
38 | $bookmark = $bs->getBookmarkByShortname($short);
39 | if ($bookmark === false) {
40 | header('HTTP/1.0 404 Not found');
41 | header('Content-Type: text/plain');
42 | echo 'No bookmark found with short name of: ' . $short;
43 | exit();
44 | }
45 |
46 | header('HTTP/1.0 302 Found');
47 | header('Location: ' . $bookmark['bAddress']);
48 | ?>
--------------------------------------------------------------------------------
/www/player/license.txt:
--------------------------------------------------------------------------------
1 | Copyright (c) 2005, Fabricio Zuardi
2 | All rights reserved.
3 |
4 | Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
5 |
6 | * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
7 | * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
8 | * Neither the name of the author nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
9 |
10 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
11 |
--------------------------------------------------------------------------------
/doc/developers/release-new-version.rst:
--------------------------------------------------------------------------------
1 | How to release a new version of SemanticScuttle
2 | ===============================================
3 |
4 | 0. Run unit tests and verify that all of them pass
5 | 1. Update ``doc/ChangeLog``
6 | 2. Update ``doc/UPGRADE.txt``
7 | 3. Update version in ``data/templates/default/about.tpl.php``,
8 | ``build.xml`` and ``doc/README.rst``
9 | 4. Create a release zip file via the build script:
10 | Just type "``phing``".
11 | 5. Make a test installation from your zip file with a fresh
12 | database. Register a user, add bookmarks etc.
13 | 6. When all is fine, it's time to release.
14 | The build script takes care for most of the
15 | tasks.
16 | Run "``phing release``", and it will upload the release to
17 | sourceforge.
18 | 7. Create a git tag and push it
19 | 8. Create the PEAR package and test it:
20 | Run ``phing package``, then
21 | ``pear upgrade dist/pear/SemanticScuttle-0.xx.tgz``
22 | 9. Publish the PEAR package: ``phing deploy-sf-pear``
23 | 10. Publish the documentation: ``phing deploy-docs``
24 | 11. Write announcement mail to the SemanticScuttle mailing list
25 | semanticscuttle-devel@lists.sourceforge.net
26 | 12. Announce the new release in the sourceforge project news
27 | https://sourceforge.net/news/submit.php?group_id=211356
28 | Help about the process is available in
29 | https://sourceforge.net/apps/trac/sourceforge/wiki/News
30 | 13. Set the default file in
31 | https://sourceforge.net/projects/semanticscuttle/files/SemanticScuttle/
32 |
--------------------------------------------------------------------------------
/doc/developers/translation.rst:
--------------------------------------------------------------------------------
1 | ===========================
2 | Translating SemanticScuttle
3 | ===========================
4 |
5 | SemanticScuttle uses gnu gettext for translation. It does not
6 | rely on the php extension but ships with a pure php implementation,
7 | php-gettext_.
8 |
9 | Using gettext from within the code is really easy:
10 | Enclose the string you want to translate in a "``T_``" function call.
11 |
12 | For example, to translate::
13 |
14 | echo "Vote for";
15 |
16 | just write ::
17 |
18 | echo T_("Vote for");
19 |
20 | .. _php-gettext: https://launchpad.net/php-gettext/
21 |
22 | Translation basics
23 | ==================
24 |
25 | We keep one base translation file, ``data/locales/messages.po``.
26 | This file is auto-generated via ``xgettext`` from all our php source files.
27 | In case you added a new string to the code that needs translation,
28 | update the base translation file by running ::
29 |
30 | $ php scripts/update-translation-base.php
31 |
32 | After that has been done, the changes to the base ``messages.po`` file
33 | need to be merged into the single language translation files,
34 | for example ``data/locales/de_DE/LC_MESSAGES/messages.po``.
35 |
36 | Updating them from the master file is as easy as running::
37 |
38 | $ php scripts/update-translation.php de_DE
39 |
40 | When the translation is ready, the ``.po`` file needs to be compiled
41 | in a machine-readable ``.mo`` file. Use ::
42 |
43 | $ php scripts/compile-translation.php de_DE
44 |
45 | to achieve that.
46 |
47 |
48 |
--------------------------------------------------------------------------------
/src/php-gettext/tests/ParsingTest.php:
--------------------------------------------------------------------------------
1 | assertEquals(
12 | 'nplurals=2; plural=n == 1 ? 0 : 1;',
13 | $parser->extract_plural_forms_header_from_po_header(""));
14 |
15 | // Extracting it from the middle of the header works.
16 | $this->assertEquals(
17 | 'nplurals=1; plural=0;',
18 | $parser->extract_plural_forms_header_from_po_header(
19 | "Content-type: text/html; charset=UTF-8\n"
20 | ."Plural-Forms: nplurals=1; plural=0;\n"
21 | ."Last-Translator: nobody\n"
22 | ));
23 |
24 | // It's also case-insensitive.
25 | $this->assertEquals(
26 | 'nplurals=1; plural=0;',
27 | $parser->extract_plural_forms_header_from_po_header(
28 | "PLURAL-forms: nplurals=1; plural=0;\n"
29 | ));
30 |
31 | // It falls back to default if it's not on a separate line.
32 | $this->assertEquals(
33 | 'nplurals=2; plural=n == 1 ? 0 : 1;',
34 | $parser->extract_plural_forms_header_from_po_header(
35 | "Content-type: text/html; charset=UTF-8" // note the missing \n here
36 | ."Plural-Forms: nplurals=1; plural=0;\n"
37 | ."Last-Translator: nobody\n"
38 | ));
39 |
40 | }
41 |
42 | }
43 | ?>
44 |
--------------------------------------------------------------------------------
/src/SemanticScuttle/DbService.php:
--------------------------------------------------------------------------------
1 |
10 | * @license GPL http://www.gnu.org/licenses/gpl.html
11 | * @link http://sourceforge.net/projects/semanticscuttle
12 | */
13 |
14 | /**
15 | * Base class for services utilizing the database.
16 | *
17 | * @category Bookmarking
18 | * @package SemanticScuttle
19 | * @author Christian Weiske
20 | * @license GPL http://www.gnu.org/licenses/gpl.html
21 | * @link http://sourceforge.net/projects/semanticscuttle
22 | */
23 | class SemanticScuttle_DbService extends SemanticScuttle_Service
24 | {
25 | /**
26 | * Database object
27 | *
28 | * @var sql_db
29 | */
30 | protected $db;
31 |
32 |
33 |
34 | /**
35 | * Database table name
36 | *
37 | * @var string
38 | */
39 | protected $tablename;
40 |
41 |
42 |
43 | /**
44 | * Returns database table name
45 | *
46 | * @return string Table name
47 | */
48 | public function getTableName()
49 | {
50 | return $this->tablename;
51 | }
52 |
53 |
54 |
55 | /**
56 | * Set the database table name
57 | *
58 | * @param string $value New table name
59 | *
60 | * @return void
61 | */
62 | function setTableName($value)
63 | {
64 | $this->tablename = $value;
65 | }
66 |
67 | }
68 |
--------------------------------------------------------------------------------
/data/templates/default/login.tpl.php:
--------------------------------------------------------------------------------
1 | includeTemplate($GLOBALS['top_include']);
3 | ?>
4 |
5 |
10 |
11 | isSessionStable()) {
13 | echo '
'.T_('Please activate cookies').'
';
14 | }
15 | ?>
16 |
17 |
38 |
39 | includeTemplate($GLOBALS['bottom_include']);
41 | ?>
--------------------------------------------------------------------------------
/data/templates/default/bookmarks-vote.inc.tpl.php:
--------------------------------------------------------------------------------
1 | ';
23 |
24 | if (isset($row['hasVoted']) && $row['vote'] != 1) {
25 | echo '+';
29 | } else {
30 | echo '+';
31 | }
32 |
33 | echo '' . $row['bVoting'] . '';
34 |
35 | if (isset($row['hasVoted']) && $row['vote'] != -1) {
36 | echo '-';
40 | } else {
41 | echo '-';
42 | }
43 | echo '';
44 | ?>
--------------------------------------------------------------------------------
/src/SemanticScuttle/Thumbnailer/Null.php:
--------------------------------------------------------------------------------
1 |
10 | * @license GPL http://www.gnu.org/licenses/gpl.html
11 | * @link http://sourceforge.net/projects/semanticscuttle
12 | */
13 |
14 | /**
15 | * Dummy thumbnailer that never returns a thumbnail URL
16 | *
17 | * @category Bookmarking
18 | * @package SemanticScuttle
19 | * @author Christian Weiske
20 | * @license GPL http://www.gnu.org/licenses/gpl.html
21 | * @link http://sourceforge.net/projects/semanticscuttle
22 | */
23 | class SemanticScuttle_Thumbnailer_Null
24 | {
25 | /**
26 | * Set dummy configuration
27 | *
28 | * @param array $config Dummy configuration
29 | *
30 | * @return void
31 | */
32 | public function setConfig($config)
33 | {
34 | }
35 |
36 | /**
37 | * Get the URL for a website thumbnail.
38 | * Always returns false.
39 | *
40 | * @param string $bookmarkUrl URL of website to create thumbnail for
41 | * @param integer $width Screenshot width
42 | * @param integer $height Screenshot height
43 | *
44 | * @return mixed FALSE when no screenshot could be obtained,
45 | * string with the URL otherwise
46 | */
47 | public function getThumbnailUrl($bookmarkUrl, $width, $height)
48 | {
49 | return false;
50 | }
51 | }
52 | ?>
53 |
--------------------------------------------------------------------------------
/data/templates/default/tagcommondescriptionedit.tpl.php:
--------------------------------------------------------------------------------
1 | includeTemplate($GLOBALS['top_include']);
3 |
4 | ?>
5 |
10 |
45 |
46 | includeTemplate($GLOBALS['bottom_include']);
48 | ?>
49 |
--------------------------------------------------------------------------------
/www/ajax/getadmintags.php:
--------------------------------------------------------------------------------
1 |
18 | * @author Christian Weiske
19 | * @author Eric Dane
20 | * @license GPL http://www.gnu.org/licenses/gpl.html
21 | * @link http://sourceforge.net/projects/semanticscuttle
22 | */
23 |
24 | $httpContentType = 'application/json';
25 | require_once '../www-header.php';
26 |
27 | $limit = 30;
28 | $beginsWith = null;
29 | $currentUserId = $userservice->getCurrentUserId();
30 |
31 | if (isset($_GET['limit']) && is_numeric($_GET['limit'])) {
32 | $limit = (int)$_GET['limit'];
33 | }
34 | if (isset($_GET['beginsWith']) && strlen(trim($_GET['beginsWith']))) {
35 | $beginsWith = trim($_GET['beginsWith']);
36 | }
37 |
38 | $listTags = SemanticScuttle_Service_Factory::get('Bookmark2Tag')->getAdminTags(
39 | $limit, $currentUserId, null, $beginsWith
40 | );
41 | $tags = array();
42 | foreach ($listTags as $t) {
43 | $tags[] = $t['tag'];
44 | }
45 |
46 | echo json_encode($tags);
47 | ?>
--------------------------------------------------------------------------------
/doc/tools.rst:
--------------------------------------------------------------------------------
1 | =================================
2 | Tools to use with SemanticScuttle
3 | =================================
4 |
5 | Scuttleoid
6 | ==========
7 | Scuttloid is an android client for managing your bookmarks that are
8 | stored on a Semantic Scuttle server.
9 | It allows to list/search your personal bookmarks, add and edit existing
10 | bookmarks, and share them to other applications.
11 |
12 | Installable via `f-droid`__.
13 | Also see the `source code`__.
14 |
15 | __ https://f-droid.org/repository/browse/?fdid=gr.ndre.scuttloid
16 | __ https://github.com/ilesinge/scuttloid
17 |
18 |
19 | Scuttle for Android
20 | ===================
21 | Scuttle for Android is a client for the Scuttle bookmarking software.
22 | Enter your Scuttle login information and you will presented with a list of your
23 | bookmarks.
24 | Touching a bookmark will load that web page in the browser.
25 | Use the browser's "Share" menu option to add bookmarks to your Scuttle.
26 |
27 | See the homepage__ and `source code`__.
28 |
29 | __ http://slideme.org/application/scuttle-android
30 | __ https://github.com/shadybrooksoftware/Scuttle-For-Android
31 |
32 |
33 | ttrss2scuttle
34 | =============
35 | Announced in a `blog post`__, the plugin for the feed reader `Tiny Tiny RSS`__
36 | allows you to bookmark any of the articles in your own SemanticScuttle
37 | instance.
38 |
39 | Source code and installation instructions are on the
40 | `ttrss2scuttle github page`__.
41 |
42 | __ http://www.versvs.net/anotacion/plugin-tiny-tiny-rss-semanticscuttle
43 | __ http://tt-rss.org/
44 | __ https://github.com/versvs/ttrss2scuttle
45 |
--------------------------------------------------------------------------------
/www/api/opensearch.php:
--------------------------------------------------------------------------------
1 | \n";
5 | ?>
6 |
7 |
8 |
9 |
10 | UTF-8
11 |
12 | Jan Seifert "jan.seifert@uid.com"
13 | semanticscuttle bookmark web
14 | data:image/gif;base64,R0lGODlhEAAQAMZ9ANaPE9mREteTHtSXLdmXIdiXJtaYKdiYJ9iYKNeaLtKdP9CdRd2dLNWfQuWiFMqjX9+hNMykXt6jPOCkPM2oaM+paeCpQuGoR+OqOeKpR+GqS9+uWeSwU+ayS+uzOeWxVeWxWOSyWOu0POazXOS0YOm8Zee8cOy+WOm9a/jBLum+bPbCNurAbe7BYuvBc/LDV/LEV+zEdv/KKf/KLP/KLf/LLuzHe//MNP/NN/nMTv/OOf/OPP/OP/jNW//PPvnOVv/QQv7QRv/QRP/RR/HOhP/SSf/STPnRav/TT//TUPfScf/UUvzUXP/UVP/VV/bTfv/WWf/WW//WXP7XYf/XX//XYP/YZPPVmf/ZZv/ZZ/vYeP/aaf/aa//abP/abf/abvvaef/bb//bcfzbfP/ccv/cc//cdP/cdf/dd//deP/def3egP/ee//efP/efv/ffv/ggf/gg//ghP/ghfrfmv/hif/ii//ijP/jkfzjm//kkv7klv/lmP///////////yH5BAEKAH8ALAAAAAAQABAAAAergH+Cg38hhIeHIFcmiIgDLnt0Go2EE1pyd0QbjQMQDC9bZGprKBcjA4IfAQMrQUhOVFlhaGNPMRl/Aw4yMzc7QkZNUlZdZmASqAJKcW1WPDpARUtQUx0RgyR5fHpzUTU4PkMiqIMVNnh2c25lSTQpAIgqdXJvaWReXz0JiCxwbWhiuGCp8uMAohJszhw5AYMJlBwFEHFoYQHBAwUEMHgwgKjBA0QLKFAaKSgQADs=
15 |
16 |
17 |
--------------------------------------------------------------------------------
/www/gsearch/context.php:
--------------------------------------------------------------------------------
1 |
13 | * @author Christian Weiske
14 | * @author Eric Dane
15 | * @license GPL http://www.gnu.org/licenses/gpl.html
16 | * @link http://sourceforge.net/projects/semanticscuttle
17 | * @link http://www.google.com/cse/docs/cref.html
18 | */
19 | require_once '../www-header.php';
20 |
21 | if ($GLOBALS['enableGoogleCustomSearch'] == false) {
22 | header('HTTP/1.0 403 Forbidden');
23 | header('Content-Type: text/plain; charset=utf-8');
24 | echo "Google Custom Search disabled."
25 | . " You can enable it into the config.php file.\n";
26 | die();
27 | }
28 | ?>
29 |
30 |
31 |
32 | <?php echo htmlspecialchars($GLOBALS['sitename']) ?>
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
--------------------------------------------------------------------------------
/data/templates/default/sidebar.block.tagactions.php:
--------------------------------------------------------------------------------
1 | isLoggedOn()) {
6 |
7 | if ($currentUser->getUsername() == $user) {
8 | $tags = explode('+', $currenttag);
9 | $renametext = T_ngettext('Rename Tag', 'Rename Tags', count($tags));
10 | $renamelink = createURL('tagrename', $currenttag);
11 | $deletelink = createURL('tagdelete', $currenttag);
12 | $tagdesclink = createURL('tagedit', $currenttag);
13 | $commondesclink = createURL('tagcommondescriptionedit', $currenttag);
14 | $addtag2taglinklink = createURL('tag2tagadd', $currenttag);
15 | ?>
16 |
17 |
18 |
del.icio.us API. Almost all of the neat tools made for that system can be modified to work with %1$s instead. If you find a tool that won\'t let you change the API address, ask the creator to add this setting. You never know, they might just do it.'), $GLOBALS['sitename']); ?>
.
15 | ')
'
16 | . '';
17 | }
18 | ?>
--------------------------------------------------------------------------------
/data/templates/default/tagdelete.tpl.php:
--------------------------------------------------------------------------------
1 | includeTemplate($GLOBALS['top_include']);
3 | ?>
4 |
5 |
17 |
18 | includeTemplate($GLOBALS['bottom_include']);
20 | ?>
--------------------------------------------------------------------------------
/data/templates/default/sidebar.tpl.php:
--------------------------------------------------------------------------------
1 | isAdmin($userid)
3 | ): ?>
4 | ';
50 | ?>
--------------------------------------------------------------------------------
/src/SemanticScuttle/Model/Bookmark.php:
--------------------------------------------------------------------------------
1 |
10 | * @license GPL http://www.gnu.org/licenses/gpl.html
11 | * @link http://sourceforge.net/projects/semanticscuttle
12 | */
13 |
14 | /**
15 | * Bookmark model class, keeping the data of a single bookmark.
16 | * It will slowly replace the old array style format.
17 | *
18 | * @category Bookmarking
19 | * @package SemanticScuttle
20 | * @author Christian Weiske